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第 一 章 : Android Studio 介绍 


译 者 : EvilSong 
来 源 : Learn Android Studio 汉化 教程 第 一 章 : Android Studio 介绍 


本 章 将 引导 您 完成 安装 和 设置 开发 环境 ,然后 你 就 可 以 跟随 本 书 的 例子 和 课程 学 习 。 首 先 ,您 将 
安装 被 称 为 Java 开 发 工具 包 (JDK) 的 必要 组 件 。 然 后 你 要 下 载 和 安装 Android Studio 以 及 
Android 软 件 开发 工具 包 (SDK), 这 些 都 是 开发 Android 应 用 程序 所 必需 的 工具 。 接 着 ， 我 们 将 向 
你 展示 如 何 使 用 新 建 项 目 向导 来 创建 一 个 简单 的 项 目 HelloWorld。 最 后 ， 我 们 将 向 你 展示 怎样 
连接 Android 虚 拟 设备 (AVD) 和 Android 物 理 设备 。 在 本 草 结 束 的 时 候 ， 你 将 在 Android 
Studio 中 拥有 开发 Android 应 用 程序 的 一 切 东 西 。 


Windows 下 安装 JDK 


本 节 适 用 于 Windows 用 户 。 如 果 你 是 Mac 用 户 ， 请 跳 转 到 下 一 节 “ 在 Mac 上 安装 JDK”。Android 
Studio 使 用 java 编 译 环境 构建 ， 因 此 在 开始 使 用 Android Studio 之 前 你 需要 确保 你 已 经 安装 
Java 开 发 工具 包 (JDK) 。 如 果 你 是 一 个 经 验 丰 富 Android 或 Java 开 发 人 员 的 话 ， 你 很 有 可 能 
已 经 在 你 的 电脑 上 安装 了 JDK。 如 果 你 的 电脑 上 的 JDK 和 运行 版 本 是 1.6 或 更 局 的 话 ， 你 可 以 跳 
过 这 一 节 。 此 外 ， 你 将 下 载 ， 安 装 和 配置 最 新 版 本 的 JDK。 你 可 以 从 下 面 的 Oracle 网 站 上 下 载 
JDK : 


http://www.oracle.com/technetwork/java/JjJavase/downloads/index.html 


打开 网 站 之 后 ， 点 击 java Download 按钮 ， 如 图 1-1 所 示 。 


| 
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图 1-1 Java 下 载 界 面 上 的 Java Download 按钮 


下 载 Windows 上 使 用 的 JDK 


下 一 步 如 图 1-2 所 示 ， 需 要 单 击 单 选 按钮 来 接受 许可 十 协议 。 然 后 选择 适合 


你 操作 系统 的 


JDK。 如 果 你 是 Windows 7 或 者 Windows 8 系统 ， 你 应 该 点 击 文件 链接 右边 窗口 的 X64 版 本 ， 


如 图 1-2 所 示 。Oracle 会 
使 用 了 ， Co 。 然 后 等 待 安装 文件 下 载 。 文 件 大 小 通 
尺 下 载 应 该 花 多 长 时 间 。 
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图 1-2 接 伙 许可 协议 ， 点 击 适 当 的 链接 


在 Windows 上 执行 JDK 人 向 导 


安装 JDK 之 前 ， 在 你 C 盘 的 根 目 录 下 新 建 一 个 名 为 Java 的 文件 夹 。 a 字 可 以 是 任意 

的 ， 之 所 以 称 为 Java 是 因为 有 许多 跟 Java 相 关 的 工具 要 安装 在 这 里 ， 包 括 JDK，Android 

Studio 和 Android SDK。 将 Android Studio 相 关 的 工具 安装 在 C:ava 目 录 下 能 够 保证 你 的 开发 

a 找到 你 浏览 器 下 载 安装 文件 的 位 置 然 后 双击 执行 。 当 安装 开始 ， 你 将 看 到 安 
装 向 导 ， 如 图 1-3 所 示 。 在 Windows 系 统 下 ，JDK 默 认 安 装 在 c:\Program Files\Java\ 目录 

下 。 要 更 改 安装 目录 的 位 置 ， 请 单 击 Change 按 钮 。 我 们 建议 安装 JDK 字 ci:N\Java 目录 下 是 因 

为 它 的 路 径 名 中 不 包含 空格 ， 很 容易 记 住 。 如 图 1-4 所 示 。 
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图 1-4 选择 JDK 安 装 目录 


记 住 JDK 的 安装 位 置 。 按 照 提 示 ， 直 到 安装 完成 。 如 果 提 示 安 装 Java 运 行 环境 (JRE) ， 选 择 
跟 JDK 安 装 位 置 相同 目 承 。 
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Windows 上 配置 环境 变量 


本 节 将 向 你 展示 如 何 配置 Windows 以 便 Android Studio 找 到 JDK。 在 电脑 上 运行 Windows， 按 
住 Windows 键 和 Pause 键 打开 系统 窗口 。 单 击 融 级 系统 设置 选项 ， 如 图 1-5 所 示 。 


Coniral Pane Har 


We bsic irulcrrraticn mr Ur er 


世 Dewicr insger re cepa 

而 Wnt stirsg Bree 7 Profaseral 

二 Sem pm pra i Beet rp hes, 
I gh nhtrv esd 
eri Pack,] 
Sr rr abuira wt rm idrhcn ef 
re 


Tyittm 

Eanmg: a wsoo-: PIT EE J 

Dracenar I Casa{T -1 
中 坟 Hs 一 向 全 

lta remorr ARM: ibD EE 

ET pe 本 和 时 Cee SET 

BT grid Touche Ma Per ew Touch lrpiak is gail ablbe fer this 
Cesplisy 


Sy he 
Sriien Coter € ppaut na Torrain, Hd workoroup tingr 
iis Udika 


Purderrragers [nf arrrasiier gnd 
Trais 


i 23=PC hon kn 
Full scraputer nam m3-PC 
TH de pir 





图 1-5 Windows 系 统 


点 击 “ 环 境 变 量 " 按 钮 ， 如 图 1-6 所 示 。 如 图 1-7 所 示 ， 在 下 面 的 系统 变量 列表 中 找 
到 JAVA_HOME 项 。 如 果 JAVA_HOME 不 和 存在， 点 击 新建 来 创建 ， 否 则 ， 点 击 编辑 。 


ER Harchware | 则 waneed | System Frotecbon | Remate | 
Tou mi be egged on 33 en Adninistratorto motes most of Bess hanges. 
Parlcemancs 
Vual ef eis, receesar sehedulrig, Freery Usace, a witud memay 


dalup Hd Mesovery 
Sle Manup. Hem lelure, a debuggrnd riomation 





图 1-6 系统 属性 
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图 1-7 环境 变量 


点 击 新 增 或 者 编辑 显示 一 个 对 话 框 如 图 1-8 所 示 。 务 必 在 变量 名 中 输入 JAVA_HOME 。 然 后 在 变 
量 值 中 输入 刚才 JDK 的 安装 位 置 (去 掉 后 面 斜 枉 ) ， 如 图 1-4 所 示 。 然 后 点 击 确定 。 
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图 1-8 编辑 JAVA HOME 环境 变量 


同样 ， 就 像 编 辑 JAVA_HOME 环 境 变量 一 样 ， 你 需要 编辑 PATH 环境 变量 。 如 图 1-9 所 示 。 将 
你 的 光标 移动 到 变量 值 的 最 后 面 然 后 输入 如 下 路 径 : 
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图 1-9 编辑 PATH 环境 变量 
然后 点 击 确定 ， 确 定 ， 确 定 ， 保 存 这 些 更 改 并 退出 系统 属性 。 


为 了 测试 新 的 JDK 安 装 成 功 ， 单 击 开始 按钮 ， 输 入 cmd ， 然 后 回 车 ， 打 开 命 令 行 窗口 。 在 命 
令 行 窗口 中 输入 以 下 命令 并 按 回 车 : 


Java -version 


如 果 你 有 如 图 1-10 所 示 的 信息 ， 茶 喜人 你 ， 你 已 经 成 功 安 装 了 JDK。 
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图 1-10 确认 JDK 安 装 成 功 


在 Mac 上 安装 Java 开 发 工具 
Mac 和 Windows 安 装 JDK 的 前 两 个 步骤 是 相同 的 。 用 浏览 器 打开 如 下 网 站 : 


http://www.oracle.com/technetwork/java/Javase/downloads/index.html 


在 界面 上 点 击 Java Download 按 钮 ， 如 图 1-11 所 示 。 
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图 1-11 Java Download 页 面 上 的 Java Download 按 钮 


下 载 Mac 上 使 用 的 JDK 


如 图 1-12 所 示 ， 点 击 接受 许可 协议 单 选 按钮 接受 许可 协议 。 然 后 你 必须 选择 适 操作 系统 
的 JDK 版 本 。 如 果 你 电脑 是 64 位 的 OS XX， 你 应 该 点 击 右 侧 的 Mac OS ye ， 图 1-12 上 所 
示 。Oracle 会 频繁 的 发 布 JDK 更 新 版 本 。 在 本 书 印 刷 之 际 ， 新 版 本 的 JDK 基 本 能 够 使 用 了 ， 所 
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以 请 下 载 最 新 版 本 的 JDK。 等 待 安装 文件 下 载 。 
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图 1-12 接受 许可 协议 ， 点 击 适当 的 链接 


Mac 上 执行 JDK 向 隆 


双击 .dmg 文件 执行 。 然 后 点 击 .pkg 文件 打开 向 导 然 后 根据 需要 继续 。 如 图 1-13 到 1-15。 
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图 1-13 JDK 8 Update 25.pkg 
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图 1-15 安装 成 功 


Mac 上 配置 JDK 版 本 


的 Mac 以 便 Android Studio 能 够 找到 合适 的 JDK。 打 开 Finder 禄 口 然后 选择 应 用 > 实用 
。 从 那里 打开 Java 偏 好 设置 ， 按 照 指 示 将 了 最 新 版 本 放置 到 列表 的 最 上 面 作 为 首选 版 本 。 


交角 Android Studio 


在 下 载 Android Studio 之 前 ， 为 本 书 中 的 课程 创建 一 个 根 目 录 。 我 们 使 用 c:\androidBook\ I 
为 本 书 的 所 有 课程 的 根 目 录 ， 但 是 你 也 可 以 选择 或 者 创建 任何 你 认为 合适 的 目录 。 出 于 这 
原因 ， 我 们 就 简单 的 成 为 课程 根 目录 。 


下 载 Android Studio 很 简单 ， 用 浏览 蜂 打 开 如 下 网 站 : 


http://ask.android-studio.org/?/developer.android.com/sdk/installing/studio.html 


点 击 Download Android studio for you 0S 绿色 大 按钮 ， 如 图 1-16 所 示 。 接 着 ， 勾 选 我 已 阅读 
并 同意 上 述 条 款 条 件 复 选 框 。 再 次 点 击 Download Android studio 按钮 ， 安 装 文 件 将 开始 下 
载 。 下 载 完 成 之 后 执行 下 载 文 件 。 
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图 1-16 下 载 Android Studio 


装 向 导 开 始 之 后 ， 点 击 Next 按 钮 一 路 向 下 直到 选择 组 件 窗口 。 勾 选 全 部 组 件 复 选 框 如 图 1- 
a "然后 人 。 再 次 同意 条 款 和 条 件 。 当 你 到 
达 configuration Settings:Install Locations 窗口 时 如 图 1-18 所 示 ， 选 择 Android Studio 和 
Android SDK 的 安装 位 置 。 为 了 保持 一 致 ， 我 们 将 Android Studio 安 装 
在 Cc:\ Java \ astudio \ 下 ， 将 Android SDK 安 装 在 c:\ Java \ asdk\ 下 。 
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图 1-17 选择 组 件 
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图 1-18 选择 Android Studio 和 SDK 人 安装 位 置 


一 路 点 击 Next 按 钮 直到 Android Studio 和 Android SDK 都 安装 完成 。 你 最 终 显 示 的 窗口 应 该 如 
图 1-19 所 示 。 勾 选 Start Android Studio 复 选 框 之 后 点 击 Finish 按 钮 后 动 Android uo 。 请 确 
保 选中 复 选 框 ， 然 后 点 击 Finish 按 钮 ，Android Studio 才 会 启动 。 请 注意 从 现在 起 ， 你 需要 从 
果 面 图 标 或 开始 菜单 中 尼 动 Android Studio 。 
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图 1-19 完成 Android Studio 设 置 


Android Studio 第 一 次 打开 的 时 候 ， 安 装 向 导 将 查找 你 系统 上 的 JDK (如 前 面 安装 的 一 个 ) 和 
Android SDK 的 位 置 。 安 装 向 导 应 该 为 你 的 Android Studio 下 载 一 切 开 始 开 发 应 用 程序 的 东 
西 。 点 击 Finish 按 钮 关闭 安装 向 导 。 
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图 1-20 安装 向 叶 - 下 载 组 件 


新 建 你 的 第 一 个 项 目 : HelloWorld 


一 旦 安装 向 导 完 成 ，Android Studio 的 欢迎 对 话 框 将 会 出 现 ， 如 图 1-21 所 示 。 点 击 Start a new 
Android Studio project 选 项 。 
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图 1-21 欢迎 来 到 Android Studio 


在 新 建 项 目 向 导 (如 图 1-22) ， 在 Application Name 输 入 Helloworld ， 在 Company Domain 
中 输入 gerber.apress.com 。 请 注意 ，Package name 是 有 反 转 的 Company Domain 加 上 
Application Name 。 创建 Helloworld 项 目 在 课程 的 根 目录 文件 夹 下 。 正 如 前 面 提 到 的 ， 如 果 
是 Windows 系 统 ， 我 们 使 用 c:\androidBook、。 如果 是 Mac 或 者 Linux 系 统 ， 你 的 根 目 录 名 称 
不 是 以 字母 开头 ， 而 是 一 个 斜 杠 。 
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Configure your new project 


Company Domain | 9erberapresscom 


Package narniEe cormapressderbet hellswedd 


eandraidBeok\HelleWerld 





图 1-22 配置 你 的 新 项 目 


Android 操 作 系 统 可 以 在 多 种 平台 上 运行 


包括 游戏 机 ， 电 视 机 ， 手 表 ， 有 眼镜， 智能 手机 和 平 


板 电脑 。 默 认 情 况 下 ， 手 机 和 平板 电脑 复 选 框 会 被 选中 ，API-8 被 选 为 最 低 的 SDK。 同 意 这 些 


设置 然后 点 击 Next， 如 图 1-23 所 示 。 
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后 续 新 项 目 向 导 将 提示 你 选择 一 种 布局 。 选 择 Blank Activity 然后 点 击 Next 按 钮 。 同 意 默 认 
名 字 ， 如 图 1-24 所 示 ， 他 们 应 该 如 下 : 


Activity Name: MainActivity 
Layout Name: activity_main 
Title: MainActivity 

Menu Resource Name: menu_main 











Phe nu od hhat ta yy Class Hy CEE 


Prur Cf CE | 


图 1-24 为 新 文件 选择 设置 


使 用 Android 虚 拟 设 备 管理 器 


Android 虚 拟 设 备 管理 器 允许 你 创建 Android 虚 拟 设备 (AVDs) ， 然 后 你 可 以 在 你 的 电脑 上 运 
行 模拟 器 。 模 拟 和 仿 卜 有 一 个 很 重要 但 是 微妙 的 区 别 。 模 拟 意味 着 虚拟 设备 只 有 一 个 外 形 ， 
模拟 实际 的 物理 设备 如 何 运 作 ， 但 是 不 针对 特定 的 操作 系统 。IOS 开 发 环境 使 用 模拟 况 ， 对 于 
有 限 数量 的 设备 的 平台 的 IDS 来 说 可 能 是 一 个 不 错 的 选择 。 


然而 对 于 仿 丨 器 而 言 ， 你 的 电脑 留 出 一 块 内 存 去 复制 基于 仿 丨 器 正在 仿 丨 设备 上 的 环境 。 
Android Studio 使 用 仿 夏 器 ， 这 意味 着 Android 虚 拟 设 备 管理 器 启动 一 个 Linux 内 核 的 大 沙 箱 和 
整个 Android 栈 为 了 仿 上 基于 Android 物 理 设备 的 环境 。 尽 管 仿 中 器 提供 了 一 个 比 模拟 器 更 可 靠 
的 环境 来 测试 你 的 应 用 程序 ， 但 是 启动 一 个 AVD 需 要 数 分 钟 ， 这 取决 于 你 电脑 的 速度 。 好 消 
息 是 你 的 仿 夏 器 仍然 活跃 在 内 存 中 ， 它 仍然 是 有 响应 的 。 然 而 ， 如 果 你 有 Android 手 机 或 者 平 
板 电 脑 ， 我 们 建议 使 用 物理 设备 来 测试 你 的 应 用 程序 ， 而 不 是 使 用 AVD。 也 就 是 说 ， 我 们 首 
先 使 用 Android 虚 拟 设备 管理 器 创建 一 个 AVD， 在 后 来 的 章节 我 们 将 想 你 展示 如 何 连 接 你 的 物 
理 设备 ， 如 果 你 有 的 话 。 


广大 
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点 击 Android 虚 拟 设 备 管 理 器 图 标 如 图 1-25 所 示 。 在 Android 虚 拟 设 备 管 理 器 向 导 的 第 一 个 界面 
中 点 击 创建 虚拟 设备 按钮 。 在 下 一 个 界面 选择 Galaxy Nexus 如 图 1-26， 然 后 点 击 Next。 下 一 
个 界面 允许 你 选择 一 个 系统 镜像 如 图 1-27。 选 择 第 一 个 选项 Lollopop (或 最 新 的 AP 和 

X86 64 的 ABl。 点 击 Next。 在 下 一 个 界面 上 ， 点 击 Finish 按 钮 来 验证 你 的 AVD 设 置 。 茶 喜 你 ， 
你 已 经 创建 了 一 个 新 的 AVD 。 
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图 1-25 AVD 图 标 
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图 1-26 选择 Galaxy Nexus 硬件 
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图 1-27 选择 x86_64 系 统 镜像 


注意 : x86 SO ， 它 仅仅 工作 在 有 限 数 量 的 Intel 世 片 组 上 。 如 果 你 安装 
x86 64 失 败 ， 请 尝试 armeabi-vxx 版 本 。 


小 贴 士 : 如 果 你 想 创 建 一 个 Android Studio 还 没有 设备 定义 的 设备 ， 我 们 建议 你 去 
phonearena.com 查找 你 的 型 号 。 在 那里 你 会 找到 技术 规格 ， 你 可 以 用 来 创建 一 个 新 设备 的 定 
义 。 在 你 创建 好 了 新 设备 的 定义 之 后 ， 使 用 相同 的 步骤 来 创建 一 个 新 的 AVD。 有 一 个 优秀 的 
第 三 方 市 场 的 Android 模 拟 器 叫 Genymotion。Genymotion 模 拟 器 对 非 商业 目的 用 户 是 免费 的 
而 且 用 起 来 不 错 。 解释 如 何 设置 和 使 用 i A 出 了 本 书 的 范围 ， 但 是 你 可 以 从 
genymotion.com 上 下 载 Genymotion 模 拟 器 


在 AVD 上 运行 HelloWorld 


在 新 创建 的 AVD 中 运行 Helloworld 应 用 程序 ， 单 机 工具 栏 上 的 绿色 运行 按钮 ， 如 图 1-28. 





G3 ‘Daout nt 
图 1-28 运行 按钮 


确保 Launch Emulator 单 选 按 钮 被 选中 ， 然 后 选择 Nexus API 21 的 组 合 框 。 点 击 OK 如 图 1-29 
所 示 . 耐 心 等 待 几 分 钟 启动 AVD。 然 后 你 应 该 能 够 看 到 Helloworld 应 用 程序 运行 在 你 的 电脑 模 
拟 器 上 。 如 图 1-30 所 示 。 
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图 1-30 模拟 器 稚 图 


在 Android 设 备 上 运行 HelloWorld 


如 前 面 所 说 ， 尽 管 AVDS 对 于 模拟 特定 的 设备 是 有 用 的 ， 尤 其 是 那些 你 手头 没有 的 设备 ， 但 是 
在 物理 设备 上 开发 应 用 程序 是 更 可 取 的 。 如 果 你 的 电脑 不 能 通过 USB 数 据 线 识别 你 的 Android 
设备 连接 ， 你 应 该 装 一 个 USB 了 驱动 程序 。 如 果 你 的 电脑 能 够 识别 你 的 Android 设 备 ， 你 无 需 安 
装 不 同 或 更 新 版 本 的 USB 了 驱动 程序 ， 因 为 这 可 能 导致 USB 连 接 失 败 。 


注意 : Mac 和 Linux 用 户 通 党 不 需要 下 载 USB 了 驱动 程序 来 连接 Android 设 备 和 电脑 。 


你 可 以 在 developer.android.com/tools/extras/oem-usb.html 上 找到 合适 的 USB 了 驱动 程序 ， 或 
者 使 用 你 最 喜欢 的 搜索 引擎 找到 适合 你 型 号 的 USB 驱 动 程序 。 下 载 驱动 程序 并 将 之 安装 在 电 
脑 上 。 在 你 的 Android 设 备 上 ， 点 击 设置 ， 然 后 打开 开发 人 员 选 项 。 确 保 USB 人 调试 检查 框 被 选 
中 。 一 些 设备 ， 如 三 星 需 要 密码 来 启用 USB 人 调试， 所 以 你 可 能 要 使 用 你 最 喜欢 的 搜索 引擎 研 
究 如 何 打 开 你 设备 上 的 USB 调 试 开 关 。 如 果 介 绍 不 太 清 晰 ，YouTube 上 一 些 视频 资源 也 可 以 
帮助 你 如 何 开 司 特定 设备 的 USB 调 斌 开关。 

大 多 数 的 Android 设 备 配 备 有 一 根 一 端 有 一 个 USB 接 口 另 一 端 有 一 个 小 型 USB 接 口 的 数据 线 。 


你 的 Android 设 备 通过 这 根 数据 线 连接 到 你 的 电脑 上 。 点 击 在 图 1-31 中 国 起 来 的 Android 设备 
监听 器 按钮 。 如 果 驱 动 程序 安装 正确 ， 你 应 该 能 够 看 到 列 出 来 的 已 连接 设备 如 图 1-32. 
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图 1-31 Android 设 备 监听 器 按 锂 
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图 1-32 Android 设 备 监听 器 显示 已 连接 的 物理 设备 


注意 : 你 的 电脑 和 你 的 Android 设 备 之 间 的 连接 是 使 用 了 一 种 叫做 Android 调 试 桥 (ADB) 的 
服务 。 如 果 你 没有 看 到 设备 ， 点 击 |DE 左 下 角 的 Terminal 按 钮 ， 输 入 以 下 命令 : 


adb start-server 


很 可 能 在 ADB 服 务 重启 之 后 你 仍然 没有 看 到 设备 。 也 许 USB 驱 动 程序 需要 电脑 重启 ， 虽 然 不 
太 可 能 。 


现在 点 击 绿色 运行 按钮 (如 图 1-28 所 示 ) 。 选 择 已 连接 的 Android 设 备 。 在 图 1-33 中 ， 已 连接 
的 设备 是 一 人 台 HTC One X 智 能 手机 。 点 击 OK， 等待 几 秒 钟 ， 你 将 看 到 Helloworld 运行 在 你 
的 Android 设 备 上 了 。 
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在 这 一 草 ， 你 安装 了 Java 开 发 工具 包 ， 或 称 JDK， 你 也 安装 了 Android Studio 和 Android 
SDK。 你 用 新 建 项 目 向 导 创 建 一 个 简单 的 HelloWorld 应 用 程序 。 然 后 你 新 建 一 个 Android 虚 拟 
设备 ， 或 称 AVD。 我 们 向 你 介绍 了 如 何 安装 所 需 的 USB 了 驱动 程序 。 最 后 ， 我 们 向 你 展示 了 怎 
样 在 AVD 和 Android 物 理 设 备 上 运行 HelloWorld。 现 在 ， 你 在 Android Studio 中 拥有 开发 
Android 应 用 程序 的 所 有 必需 的 软件 。 
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译 者 : EvilSong 
来 源 : 


e。 Learn Android Studio 汉化 教程 第 二 章 : Android Studio 概 述 (一 ) 
。 Learn Android Studio 汉化 教程 第 二 章 : Android Studio 概 述 (二 ) 


Android Studio 是 一 个 视窗 化 的 开发 环境 。 为 了 充分 ee 间 ， 不 让 你 束 手 束 脚 ， 
Android Studio 在 特定 的 时 间 仅 仅 显示 一 小 部 分 可 用 窗口 。 除 了 一 些 上 下 文敏 感 的 窗口 和 上 下 
文 相关 的 窗口 显示 出 来 外 ， 才 ni 
窗口 直到 你 主动 隐藏 它们 。 为 了 充分 利用 Android Studio， 你 就 需要 明白 这 些 窗口 的 功能 以 及 
如 何 、 何 时 去 显示 它们 。 在 这 一 草 ， 我 们 将 向 你 展示 如 何 管 理 Android Studio 的 窗口 。 


任何 一 个 集成 开发 环境 (IDE) 的 基础 功能 就 是 导航 。Android 项 目 通常 是 由 许多 的 包 ， 目 录 
和 文件 组 成 ， 甚 至 一 个 稍微 复杂 的 Android 项 目 能 够 包含 数 百 个 这 a 源 。 你 使 用 Android 
Studio 的 效率 很 大 程度 上 取决 于 你 处 理 这 些 资 源 的 舒适 程度 。 在 这 ， 我 们 还 将 展示 在 
Android Studio 中 如 何 使 用 导航 。 


最 后 ， 我 们 将 向 你 展示 如 何 使 用 Android Studio 中 的 帮助 系统 。 为 了 充分 理解 这 一 草 ， 我 们 打 
开 第 一 章 创 建 的 HelloWorld 项 目 。 如 果 项 目 已 经 在 Android Studio 中 打开 ， 说 明 你 已 经 准备 好 
了 。 请 参考 图 2-1， 我 们 将 讨论 下 面 的 导航 功能 。 
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图 2-1 Android Studio 集 成 开发 环境 


任何 IDE 的 主要 目的 就 是 编辑 文件 。 正 如 人 们 所 预料 的 ， 在 Android Studio 中 允许 用 户 编辑 文 
件 的 窗口 位 于 IDE 的 中 心 。 在 所 有 的 窗口 中 ， 编 辑 窗 口 是 唯 一 一 个 一 直 可 见 并 位 于 中 心 的 窗 
口 。 事 实 上 ， 编 辑 窗口 在 Android Studio 中 无 处 不 在 ， 所 以 从 现在 起 我 们 称 它 为 编辑 器 。 所 有 
在 Android Studio 中 围绕 在 编辑 器 周围 的 其 他 窗口 都 被 称 为 工具 窗口 和 侧 窗 口 Ce ， 压 部 ， 
右 部 ) 。 


编辑 器 是 一 个 类 似 于 现代 WEB 浏 览 器 的 选项 卡 式 的 窗口 。 当 你 从 工具 窗口 ， 键 盘 快捷 键 或 上 
下 文 菜单 打开 一 个 文件 的 时 候 ， 文 件 将 作为 一 个 选项 卡 显示 在 编辑 器 中 。 表 你 新 建 的 第 一 个 
项 目 Helloworld 中 ， MainActivity.java 和 activity_main.xml 作为 选项 卡 自动 加 载 在 编 
辑 器 中 。Android Studio 试 图 揣测 你 想 开 始 编辑 哪些 文件 ， 然 后 在 新 项 目 向 导 完 成 后 自动 作为 
选项 卡 在 编辑 器 中 打开 。 几 乎 任何 文件 能 够 在 编辑 器 中 打开 ， 虽 然 原始 图 像 和 声音 文件 还 不 
能 在 Android Studio 中 编辑 。 你 也 可 以 从 工具 禄 口 拖 搜 文 件 到 编辑 器 ， 这 样 做 可 以 直接 作为 选 
项 卡 在 编辑 器 中 打开 。 





编辑 器 上 面 是 编辑 选项 卡 。 在 左边 沿 是 边 列 ， 在 右边 沿 是 编辑 栏 。 让 我 们 开始 探索 吧 。 


编辑 选项 卡 


在 Android Studio 中 切换 选项 卡 可 以 使 用 ctrl 或 ALt+ 左 或 右 箭头 。 当 然 ， 你 也 可 以 用 鼠标 选择 
编辑 选项 卡 。 编 辑 器 选项 卡 的 选项 位 于 主 菜 单 栏 的 Window>Editor Tabs 下 。 你 在 此 处 进行 的 
任何 操作 都 将 应 用 于 当前 选中 的 选项 卡 上 。 将 你 的 鼠标 放置 在 ee java 选项 卡 并 右 
击 它 (Mac 下 按 住 ctrl 点 击 ) 。 如 图 2-2 所 示 ， 在 生成 的 菜单 中 ， 你 会 看 到 很 多 

跟 window>Editor Tabs 下 相同 的 选项 。 从 这 个 菜单 中 ， 选 择 Tabs Placement 子 菜单 。 此 菜单 
选项 允许 你 将 选项 卡 移动 到 上 ， 下 ， 左 ， 右 。 将 选项 卡 移动 到 左边 或 右边 能 容纳 更 多 可 见 的 
选项 卡 ， 但 是 会 占用 部 分 屏幕 。 
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图 2-2 内 容 菜 单 编辑 选项 卡 


编辑 器 菜单 上 的 Close 和 Close All 操 作 是 很 明确 的 。 而 你 想 关 闭 除 此 之 外 的 所 有 选项 卡 ， 你 应 
该 使 用 Close Others。 而 Split Vertically 和 Split Horizontally 操 作用 来 将 编辑 器 细 分 成 窗口 。 如 
果 你 想 比 较 两 个 文件 那么 Split Vertically 将 会 很 有 用 。 你 可 以 无 止境 的 进行 细 分 ， 尽 管 这 种 误 
套 分 割 的 效果 大 大 降低 。 你 也 可 以 将 其 他 窗口 的 文件 拖 搜 到 编辑 器 的 任何 面板 ， 或 者 从 一 个 

面板 到 另 一 个 面板 。 当 最 后 一 个 选项 卡 关 闭 的 时 候 ， 整 个 面板 就 会 消失 。 


边 列 
列 用 于 传递 你 代码 的 信息 。 也 许 边 列 最 明显 的 特性 就 是 在 你 代码 的 同一 行 用 小 色 卡 或 者 小 


边 
图 标 来 显示 那些 可 视 化 资源 。 边 列 也 可 以 用 于 设置 断 点 ， 支 持 代 码 折 鸽 ， 并 用 作 代 码 范 围 指 
示 器 。 所 有 这 些 特性 将 会 在 后 续 的 章节 中 详细 介绍 。 


标记 栏 


编辑 绒 的 右边 十 标 记 栏 。 标 记 栏 用 于 指示 你 资源 文件 中 重要 行 的 位 置 。 例 如 ， 当 你 的 Java 或 


XML 文件 出 现 警告 信息 高 完 显示 这 些 信 息 。 右 边栏 也 会 显示 未 提交 的 
更 改 ， 搜 索 的 结果 和 书签 的 位 置 0 Wh ， 相 有 反 ， 标 签 栏 上 的 彩色 标记 


是 文件 长 度 的 相对 定位 。 点 击 标签 ra 即 跳 转 到 文件 的 位 置 。 现 在 通过 点 击 
一 些 彩 色 标 记 来 练习 使 用 标签 栏 


具 按 得 


你 应 该 已 经 看 到 了 默认 显示 在 左边 面板 的 项 目 工具 窗口 。 你 可 以 点 击 主 菜单 上 

的 View>Tool Windows 来 查看 全 部 的 工具 窗口 。 现 在 你 可 以 仔细 的 观 宵 |DE 的 左边 ， 右 边 和 下 

边 。 你 会 发 现 工 具 按 钮 相对 应 的 窗口 。 注 意 ， 有 一 些 工具 按钮 后 面 有 一 个 数字 ， 这 些 数字 结 

合 Alt (Mac 上 的 cmd ) 键 用 来 打开 /关闭 相应 的 工具 窗口 。 尝 试点 击 这 些 工 具 按 钮 来 练习 这 
项 技能 。 同 时 使 用 键盘 快捷 键 Alt+1|cmd+t1 ， ALt+2|Cmd+2 ， Alt+3|Cmd+3 等 打开 /关闭 工具 窗 


品 o 


当 茶 个 工具 窗口 打开 之 后 ， 相 应 的 工具 按钮 呈 深 灰色 ， 表 示 不 能 按 下 。 请 注意 位 于 边缘 角落 
的 工具 按 4 钮 。 例 如 ，Project 的 默认 位 置 在 左上 角 ，Favorites 的 默认 位 置 在 左下 角 。 


侧 边 栏 (左边 ， 下 边 ， 右 边 ) 可 以 同时 被 两 个 工具 窗口 共享 。 同 时 打开 Favotites 和 Project 工 
具 窗 口 看 看 侧 边栏 是 如 何 共 享 的 。 可 以 看 和 到，Favorites 和 Project 工 具 窗 口 位 于 同一 边 的 相对 
的 角落 。 两 个 位 于 相同 角落 的 工具 窗口 是 不 会 同时 出 现在 一 个 侧 窗 格 窗口 的 。 例 如 ，Project 
和 Structure 工 具 窗 口 不 能 够 同时 显示 出 来 一 至 少 在 Android Studio 的 默认 配置 上 不 会 。 


默认 布局 


不 要 将 Android Studio 中 的 默认 布局 和 Android SDK 中 的 布局 混为一谈 。 默 认 布 局 是 聚集 在 编 
辑 绒 周围 的 一 组 特定 的 工具 禄 口 。Android Studio 打 开 之 后 配置 一 个 将 Project 工 具 窗 口 显 示 在 
左边 的 默认 布局 。 以 前 布局 显示 如 图 2-1 所 示 。 


让 我 们 看 看 主 菜单 上 的 Window 菜 单 。 前 两 个 菜单 项 是 Store Current Layout as Default (将 当 
前 布局 存储 为 默认 布局 ) 和 Restore Default Layout (恢复 默认 布局 ) 。 恢 复 默 认 布局 通常 用 
在 IDE 窗 口 变 得 拥挤 ， 或 者 你 想 清理 面板 将 之 还 原 到 你 熟悉 的 布局 。 你 也 可 用 通过 打开 ， 关 
闭 ， 调 整 或 者 重新 定位 你 喜欢 的 窗口 ， 然 后 选择 将 当前 布局 存储 为 默认 布局 来 设置 新 的 默认 
布局 。 


重新 定位 工具 按钮 


正如 前 面 所 提 到 的 ，Project 和 Structure 工 具 窗 口 之 所 以 不 能 够 同时 显示 ， 是 因为 他 们 相应 的 
工具 按钮 位 于 相同 的 角落 。 但 是 你 可 以 任意 移动 工具 按钮 到 你 想 要 的 角落 。 将 Structure 工 具 
按钮 拖 搜 到 左下 角 的 角落 。 现 在 ， 使 用 键盘 快捷 键 Alt+1|cmd+1 和 Alt+7||cmd+7 或 者 点 击 工 


具 按 钮 来 打开 Project 和 Structure 工 具 窗 口 。 由 于 我 们 将 这 两 个 工具 按钮 移动 到 相反 的 角落 ， 
所 有 Project 和 Structure 能 够 在 相同 的 面板 窗口 同时 地 展现 出 来 。 


导航 工具 窗口 


本 节 讨 论 专门 用 作 导 航 的 工具 窗口 : Project ， Structure ，Favorites ， TODO 和 Commander 。 
表 2-1 列 出 了 他 们 每 个 导航 窗口 的 功能 。 之 后 的 章节 将 讨论 许多 其 他 工具 窗口 。 


表 2-1 导航 工具 窗口 


工具 窗口 PC 快捷 键 “Mac 快捷 键 ”功能 


Project Alt+1 Cmd+1 允许 你 浏览 项 目 中 的 文件 和 资源 

Favorites Alt+2 Cmd+2 显示 收藏 来， 书签 和 断 点 

Structure Alt+7 Cmd+7 当前 文件 中 的 对 象 或 元 素 以 分 层 树 的 形式 呈现 
Commander 类 似 于 Project， 但 是 允许 更 便捷 管理 文件 
TODO 将 项 目 中 的 所 有 活动 事项 显示 在 一 个 列表 中 


项 目 工具 窗口 


我 们 发 现 Project 工 具 窗 口 是 非常 有 用 的 导航 工具 窗口 ， 因 为 它 将 有 限 的 宽度 空间 和 相对 容易 
的 访问 结合 起 来 。 为 了 欣赏 Project 工 具 窗 口 的 效用 ， 你 要 将 Project 设 置 为 窗口 模式 。Project 
总 共有 三 种 模式 ; Project，Packages 和 Android。Android Studio 在 默认 情况 下 将 模式 设置 为 
Android。Android 和 Project 是 非 党 有 用 的 模式 ， 即 使 Android 模 式 可 能 为 你 隐藏 东 些 目录 。 模 
式 设 置 组 合 框 毗邻 1DE 的 左上 角 Project 按 钮 并 与 之 呈 90 度 角 。Project 工 具 窗 口 提 供 了 一 个 简 
单 的 内 套 接口 文件 和 目录 树 来 方便 你 切换 。Project 工 具 窗 口 呈 现 你 项 目 中 的 所 有 包 ， 目 录 和 
文件 的 概览 。 如 果 你 在 项 目 工 具 窗 口中 右 击 (mac 下 按 住 ctrl 单 击 ) ， 将 会 显示 一 个 上 下 文 
菜单 。 此 处 有 三 个 重要 的 菜单 项 : 复制 路 径 ， 文 件 路 径 和 在 资源 管理 器 中 显示 。 点 击 Copy 
Path 复 制 操作 系统 的 绝对 路 径 到 剪贴 板 。 点 击 File Path 以 倒序 方式 显示 目录 堆栈 ， 点 击 任何 
一 个 目录 都 将 在 操作 系统 中 打开 他 们 。 点 击 Show in Explorer 将 会 在 你 的 操作 系统 中 打开 一 个 
新 窗口 来 显示 文件 。 如 图 2-3. 
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图 2-3 项 目 工具 守 口 


结构 工具 窗 


结构 工具 窗口 用 来 显示 文件 中 元 素 的 层次 结构 。 当 编辑 器 显示 诸如 MainActivity.java 的 java 
源 文件 时 ，Structure 工 具 禄 口 将 会 以 树 状 形 式 呈 现 元 率 ， 如 字段 ， 方 法 和 内 部 类 。 当 编辑 器 
显示 诸如 activity main.xml 的 XML 文件 时 ，Structure 工 具 窗 口 以 树 状 结构 呈 示 XML 元 素 。 在 
Structure 工 具 窗 口中 点 击 任何 元 素 ， 光 标 将 会 立即 移动 到 编辑 器 中 的 该 元 素 上 。Structure 工 
具 窗 口 特别 适合 导航 超大 源 文 件 中 的 元 素 。 通 过 打开 Structure 工 具 窗 口 和 导 
航 MainActivity.java 与 activity main.xml 中 的 元 素来 练习 此 技巧 。 如 图 2-4 所 示 。 
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图 2-4 结构 工具 


收藏 夹 工 具 窗 口 


当 在 Android 中 开发 一 个 功能 (或 者 调试 bug) 的 时 候 ， 你 可 能 会 创建 或 修改 一 些 相 关 文件 。 
中 等 复杂 的 Android 项 目 可 能 包含 数 百 单个 文件 ， 因 此 ， 具 有 分 组 相关 文件 的 能 力 是 非常 有 用 


。 Favorites 工 具 窗 口 能 够 容纳 那些 你 将 实际 上 位 于 你 项 目 中 完全 不 同 的 地 方 的 相关 文件 进 
逻辑 分 组 的 最 爱 。 


将 MainActivity.]Jjava 和 activity_main.xml 文件 在 编辑 器 选项 卡 中 打开 在 任意 一 个 选 先 项 卡 
上 右 击 (Mac 下 按 住 ctrl 单 击 ) ， 在 上 下 文 菜单 中 选择 Add All to Favorites。 在 Input new 

favorites list name 中 输入 main 然后 点 击 OK。 如 果 Favorites 工 具 窗口 没有 打开 ， 通 

过 Alt+2|cmd+2 来 打开 。 展开 列表 中 的 main ， 然 后 通过 双击 来 打开 /激活 其 中 的 一 个 文件 。 


就 像 Favorites 窗 口 能 够 让 你 立即 导航 到 特定 文件 或 文件 组 一 样 ， 书 签 能 够 让 你 快速 导航 到 文 
件 的 特定 行 。 将 你 光标 放 到 MainActivity.java 的 任意 一 行 。 按 一 下 F11 (Mac 下 按 F3)。 
这 个 操作 便 是 创建 或 者 删除 资源 文件 包括 XML 文 件 中 的 书签 。 观 稍 边 列 es 
黑色 标记 来 指示 新 的 标签 。 通 过 打开 Favorites 工 具 窗 口中 的 书签 来 查看 你 刚刚 创建 的 书 


O 〇 


注意 : 在 PC 上 ， 如 果 F11 没有 响应 ， 请 确保 你 键盘 上 的 F-Lock 键 是 激活 的 。 


译 者 注 : Android Studio 一 直 在 升级 ， 此 处 F11 没 有 效果 的 童鞋 可 以 通过 查看 点 击 菜 单 栏 
的 Navigate >Bookmarks 来 查看 标签 快捷 键 。 


轴 点 是 用 来 调试 的 。 不 像 标签 ， 可 以 在 任何 文件 中 进行 设置 ， 断 点 只 能 在 java 文 件 中 进行 设 
。 打开 MainActivity.java ， 然 后 在 如 下 代码 行 的 边 列 上 单 击 : 


setContentView(R.1layout.activity_main); 


你 会 发 现 一 个 红色 圆圈 出 现在 边 列 ， 并 且 整 行 代码 都 是 红色 高 亮 的 。 断 点 只 能 被 设置 在 可 执 
行 的 代码 行 上 ; 举 个 例子 ， 机 注释 行 上 设置 断 点 ， 并 没有 什么 效果 。 打 开 Favorites 工 具 
窗口 中 的 Breakpoints 查 看 你 刚刚 创建 的 断 点 。 你 可 以 用 断 点 做 很 多 有 趣 的 事 ， 在 之 后 的 第 12 
草 ， 我 们 将 讨论 用 bay 。 


TODO 工 具 客 


TODO 的 意思 当然 是 要 做 的 事 。TODO 本 质 上 是 用 于 程序 员 们 和 他 们 的 合作 者 表明 还 要 做 的 
事 。TODO 写 法 跟 注 释 类 似 ， 以 双 斜 枉 开头， 然后 TODO 大 写 ， 后 面 跟 一 个 空格 。 例 如 : 


//TODO inflate the layout here. 


在 MainActivity.java 中 创建 一 个 TODO 然 后 打开 TODO 工 具 窗 口 ， 就 可 以 看 到 它 。 在 TODO 
工具 窗口 中 点 击 一 个 TODO， 将 会 立即 跳 转 到 源 代码 中 的 TODO 。 


Commander 工 具 窗 口 


Commander 工 具 窗 口 是 左右 窗 格 的 导航 。 这 些 窗 格 的 功能 类 似 Project 和 和 Structure 工具 窗口 。 
Commander 窗 口 和 其 他 导航 窗口 的 不 同 之 处 在 于 ， 它 在 一 个 时 间 段 内 只 显示 一 个 目 人 次 ， 
而 不 是 显示 目录 树 。 如 果 你 很 喜欢 窗口 样式 的 导航 或 者 你 觉得 Project 工 具 窗 口 太 繁 正 ， 

么 ，Commander 工 具 禄 口 可 能 是 一 个 很 好 的 导航 选择 。 


译 者 注 : 本 书 由 于 出 版 比较 早 ， 所 以 Android Studio 某 些 功 能 已 经 经 过 大 改 ， 比 如 
Commander 已 经 在 新 版 本 中 消失 ， 所 以 ， 各 位 童鞋 可 以 酌情 参考 。 


主 菜单 档 
不 一 


主 菜单 栏 位 于 Android Studio 的 最 上 面 ， 你 几乎 可 以 利用 主 菜单 和 其 子 菜单 来 执行 任何 操作 。 
不 像 Android Studio 中 其 他 的 一 些 菜 单 ， 主 菜单 不 能 被 隐藏 。 不 要 被 主 菜单 和 pd 
‘ 。 即使 经 验 丰 富 的 Android 开 发 者 也 在 日 常 编码 中 仅仅 使 用 其 中 的 一 小 部 分 ， 更 多 的 则 是 

过 快捷 键 和 相应 的 上 下 文 菜单 实现 。 我 们 将 在 后 面 的 章节 中 讨论 主 菜单 栏 中 大 部 a 


具 栏 
、 


工具 栏 中 包含 一 些 频繁 使 用 的 文本 操作 按钮 ， 例 如 剪 切 、 复 制 、 粘 贴 、 撤 销 、 重 做 。 正 如 你 
在 第 一 章 看 到 的 ， 工 具 栏 中 还 包含 各 种 各 样 的 管理 器 ， 包 括 SDK 管 理 器 和 Android 庶 拟 设 备 管 


理 颈 。 AS 助 按 钮 以 及 运行 和 调试 应 用 程 邦 序 按钮 工具 栏 中 所 有 的 按钮 都 
有 相应 的 菜单 项 和 快捷 键 。 高 级 用 户 可 以 通过 取消 义 选 View 下 的 Toolbar 菜单 项 来 释放 屏幕 空 
间 。 

导航 栏 


导航 栏 是 以 水 平 箭头 的 链 状 结构 方式 来 显示 从 项 目 根 目录 (左边 ) 依次 到 编辑 器 (右边 ) 中 
选中 的 选项 卡 。 导 航 栏 可 以 用 来 导航 你 项 目 中 的 资源 文件 而 不 必 通 过 Project 或 者 Commander 
工具 窗口 。 


状态 栏 


如 图 2-5 所 示 (以 前 在 图 2-1) ， 状 态 栏 显示 一 些 相关 的 和 上 下 文敏 感 反馈 信息 ， 上 比如 正在 运行 
中 的 进程 或 者 你 项 目 中 Git 版 本 库 状 态 的 信息 。 现 在 我 们 将 详细 的 讨论 一 下 状态 栏 。 


Lins Separator Area File Access Indicator Area 


国 Baste from dipboard 15 CRIF * UTF8 = 饭 





Toggle Margins Button Message Area Editor Gursor Position Area Text Format Area Highlighting Level Button 


图 2-5 状态 栏 


在 最 左边 角落 里 的 是 边栏 切换 按钮 。 单 击 此 按钮 就 可 以 隐藏 或 者 显示 边栏 。 另 外 ， 当 你 的 鼠 
标 悬 停 在 上 面 的 时 候 ， 会 出 现 一 个 上 下 文 菜单 以 便 你 激活 任意 一 个 工具 窗口 。 


消息 区 域 用 来 提供 反馈 信息 ， et 过 程 中 的 所 有 信息 。 当 你 在 UI 上 比如 菜单 项 或 者 
工具 栏 的 按钮 上 滚动 鼠标 的 时 候 ， 这 块 区 域 会 显示 相应 的 提示 。 点 击 这 块 区 域 打开 事件 日 


二 o 


人 心 


编辑 器 光标 位 置 区 域 以 行 : 列 的 形式 显示 编辑 器 中 光标 的 位 置 。 点 击 这 块 区 域 激活 对 话 框 来 
直接 导航 到 你 代码 中 特定 的 行 。 


行 间隔 符 区 域 用 来 显示 你 文本 文件 中 的 回 车 键 格 式 。 在 Windows 下 默认 使 用 CRLF 代 表 回 车 换 
行 。 如 果 是 Unix 和 Mac 机 器 的 话 则 使 用 LF，Git 中 一 样 。 如 果 你 在 Windows 电脑 上 开发 的 话 ， 
Git 通 第 会 在 你 提交 代码 的 时 候 自 动 将 CRLF 改 为 LF。 


文本 格式 区 域 用 来 源 文件 中 的 文本 编码 格式 。 默 认 是 UTF-8， 是 ASCII 的 超 集 ， 它 包含 了 大 部 
分 的 西 文字 母 和 标准 Java 或 XML 文件 中 的 所 有 字符 。 


文件 访问 指示 器 区 域 能 够 在 读 / 写 和 只 读 之 间 切 换 。 解 锁 图 标 意味 着 在 当前 编辑 器 中 具有 读 / 写 
功能 。 锁 定 图 标 意味 着 编辑 器 中 的 文件 是 只 读 的 。 你 可 以 通过 点 击 指示 图 标 来 切换 设置 。 


点 击 高 亮 等 级 按钮 ， 激 活 一 个 带 滑 块 按钮 的 对 话 框 ， 在 这 你 可 以 设置 代码 中 高 亮 显 示 的 等 
级 。 


默认 设置 是 Inspections， 对 应 一 个 皱 着 眉头 的 审查 经 理 图 标 。 此 设置 为 了 帮助 你 ， 审 查 经 理 
将 对 你 代码 中 的 语法 错误 和 被 称 作 警告 的 可 能 出 现 的 问题 进行 严格 的 检查 。 你 可 以 在 标记 栏 
上 看 到 审查 经 理 生 成 的 黄色 警告 标识 。 


滑动 块 的 下 一 个 设置 是 Syntax， 对 应 一 个 侧 着 脸 的 审查 经 理 的 图 标 。 这 个 设置 下 ， 审 查 经 理 
是 睁 一 只 了 眼 闭 一 只 有 眼 的 。Syntax 检 查 不 如 |nspections 严 格 ， 但 是 仍然 会 高 完 显 示 阻 止 代码 编 
译 的 语法 问题 。 


最 后 一 个 高 沈 模 式 是 None， 对 应 一 个 微笑 着 的 审查 经 理 图 标 。 这 个 图 标 让 我 想到 审查 经 理 很 
开心 并 且 不 关心 你 的 代码 。 这 种 模式 下 ， 即 使 是 最 严重 的 语法 错误 也 会 被 忽略 ， 尽 管 当 你 试 
图 构建 的 时 候 编 译 器 仍然 会 阻止 。 我 建议 将 高 亮 等 级 设置 为 Inspections 并 且 学 会 欣赏 审 查 经 
理 的 “严厉 的 爱 ”。 


第 用 操作 


本 节 介 绍 在 Android Studio 中 的 各 种 常用 操作 。 如 果 你 使 用 过 像 微软 的 Word 类 似 的 文本 编辑 器 
的 话 ， 那 么 你 可 能 对 这 节 比 较 熟 悉 。 


选择 文本 


正如 你 想 的 那样 ， 任 何 一 个 好 的 文本 编辑 器 ， 在 源 文 件 中 双击 任何 单词 就 能 够 选中 它 。 此 

外 ， 单 击 并 拖 动 光标 选择 单词 或 者 字母 中 的 文本 元 系 。 将 光标 放 在 源 文件 中 ， 并 按 

下 Shift+ 下 箭头 或 者 Shift+ 上 箭头 来 选择 从 光标 处 开始 的 行文 本 。 在 行文 本 的 任何 地 方 三 击 来 
选择 整 行 。 按 下 Ctrl+A|Cmd+A 过 选择 文件 中 的 所 有 文本 2 


如 果 你 将 光标 放置 在 任何 单词 上 ， 并 按 下 ctrl+w|ALt+ 上 箭头 将 会 选中 整个 单词 。 如 果 你 继续 
按 下 ctrL+wW|ALt+ 上 箭头 ， 将 会 无 止境 的 选择 相 邻 的 文本 。 如 果 此 时 你 按 

和 rr ， 文本 选择 将 会 收缩 。 这 种 增加 /减少 选择 的 功能 在 Android Studio 
中 被 称 为 结构 化 选择 。 


使 用 撤销 和 重 做 


撤销 和 重 做 命令 对 于 回 深 有 限 数 量 的 编辑 操作 是 非常 有 用 的 。 特 殊 的 Ul 事件 比如 按 下 Enter 或 
者 重新 定位 鼠标 用 来 限 改变 。 撤 销 和 重 做 的 快捷 键 分 别 
是 Ctrl+Z|Cmd+Z 和 Ctrl+Shift+Z|Cmd+Shift+zZz 2?° 工具 栏 左 边 的 兹 色 左 右 箭 衣 头 也 分 别 代表 撤销 和 重 


做 。Android Studio 会 记 住 你 上 次 保存 至 今 的 所 有 步骤 或 者 达到 上 限 300 步 。 撤 销 和 重 做 只 和 有 
在 一 段 时 间 内 应 用 到 一 个 文件 ， 因 此 ， fmt ， 将 在 第 7 章 by 。 


查找 取 近 文件 


Android Studio 中 最 好 的 特性 是 它 记 住 了 你 最 近 是 用 过 的 所 有 文件 。 
择 view>Recent Files 或 者 按 下 ctrl+E|cmd+E 来 激活 这 个 命令 。 A 选择 任何 最 
近 的 文件 ， 并 将 之 作为 编辑 器 中 的 一 个 选项 卡 来 打开 。 默 认 只 能 记 住 之 前 的 50 个 文件 。 你 可 


以 通过 File >Settings >Limits >Editor >Recent Files Limit 来 修改 这 些 限 制 。 


遍历 最 近 导 航 操 作 


Android Studio 也 能 够 记 住 你 最 近 的 导航 操作 。 导 航 操 作 包 括 指 和 针 移 动 、 标 签 变 更 和 文件 激 
活 。 按 下 Ctrl+tAlt+ 左 箭头 |Cmd+Alt+ 左 箭头 或 者 Ctrl+ALt+ 右 箭头 |Cmd+ALt+ 右 箭头 来 遍历 你 的 导航 
操作 历史 。 注 意 ， 导 航 操 作 不 同 于 编辑 操作 ; 如 果 你 想 遍历 你 的 编辑 操作 ， 你 应 该 使 用 撤销 
和 重 做 。 


剪贴 ， 复 制 ， 外 贴 


如 果 你 使 用 过 任何 的 文本 编辑 器 或 者 文档 处 理 器 ， 你 应 该 熟悉 剪 切 、 复 制 和 粘贴 。 表 2-2 列 出 
了 这 些 基 本 命令 以 及 一 些 扩展 的 剪贴 板 命令 。 


表 2-2 剪贴 ， 复 制 ， 粘 贴 


Command PC Keys Mac Keys 

Cut Ctrl 十 闪 Cmd+X 

Copy Ctrl+G Cmd+CG 

Paste Ctrl+V Cmd+V 
Extended Paste Gtriroshiftt+V Cmd+Shift+V 
Copy Path Ctrli+shitt+C Cmd+Shiftt+C 
Copy Reference Ctrl+Alt+Snlft+C Cmd+Alt+Sshitt+CG 


除了 协同 剪贴 板 提 供 的 一 些 简单 的 剪 切 、 复 制 和 粘贴 操作 ，Android Studio 扩 展 了 剪贴 板 的 功 
能 ， 能 够 记 住 之 前 五 步 剪 贴 和 粘贴 操作 。 在 Android Studio 运 行 的 时 候 ， 当 你 从 Android 
Studio 剪 切 或 者 复制 文本 (或 者 任何 其 他 的 应 用 程序 ) 的 时 候 ，Android Studio 将 会 将 这 些 文 
本 放 到 一 个 堆栈 中 。 按 下 ctrl+shift+v|cmd+shift+v 就 能 够 看 到 扩展 的 剪贴 板 扒 栈 。 结 果 对 话 
框 允许 你 选择 粘贴 其 中 一 项 。 如 图 2-6 所 示 。 


第 二 章 : Android Studio 概 述 


呈 丰 订 
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图 2-6 展开 剪贴 板 


你 也 可 以 通过 导航 栏 上 的 File >Setting >Limits >Editor >Maximum Number of Contents 来 更 改 
扩展 剪贴 板 上 内 容 的 数量 。 你 也 可 以 通过 在 选中 的 文本 上 右 击 ， 然 后 选择 Compare with 
Clipboard 项 来 将 当前 选中 的 文本 和 剪贴 板 中 最 近 的 元 素来 进行 比较 。 


复制 路 径 命 令 ctrl+Shift+C|Cmd+Shift+C 用 来 复制 任何 文件 的 物理 路 径 或 者 Project 或 
Commander 工 具 窗 口中 文件 夹 的 路 径 或 者 编辑 器 中 选项 卡 的 路 径 。 在 终端 会 话 中 复制 路 径 操 
作 是 非常 有 用 的 。 


Ctrl+Alt+Shift+C|Cmd+Alt+Shift+C 命令 ，Android Studio 能 够 复制 一 个 逻辑 引用 到 方法 、 

变量 或 类 中 。 当 你 将 这 个 引用 复制 到 另 一 个 源 文 件 的 时 候 ，Android Studio 会 自动 的 包含 所 需 
的 所 有 修饰 竺 和 imports。 你 也 可 以 在 Commander 和 Project 工 具 窗 口中 的 包 、 目 录 和 文件 中 使 
用 人 荔 切 、 复 制 和 粘贴 来 代替 鼠标 直接 拖 搜 来 整理 你 项 目 中 的 资源 文件 。 


上 下 文 菜单 
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大 多 数 的 上 下 文 菜单 都 可 以 在 IDE 中 通过 右 击 来 激活 (mac 下 按 住 ctrl 单 击 ) 。 在 剖面 的 草 
节 ， 你 已 经 学 习 了 编辑 器 选项 卡 的 上 下 文 菜单 。Android Studio 中 的 大 多 数 的 窗 格 ， 图 标 和 边 
栏 ， 如 果 你 右 击 (mac 下 按 住 ctrl 单 击 ) 将 会 出 现 一 个 上 下 文 菜单 。Android Studio 的 最 大 
优势 是 执行 一 个 操作 仅仅 一 种 方式 。 这 种 宛 余 意味 着 你 可 以 根据 你 自己 的 喜好 习惯 来 免费 扩 
展 你 的 技能 和 习惯 。 我 发 现 一 些 频 繁 的 操作 使 用 快捷 键 ， 而 对 一 些 低 频率 的 操作 使 用 菜单 和 
上 下 文 菜单 进行 操作 是 非常 有 效 的 方法 来 使 用 Android Studio。 接 下 来 通过 右 击 (mac 下 按 
住 ctrl 单 击 ) IDE 的 边栏 ， 选 项 卡 ， 窗 格 和 文件 来 探索 上 下 文 菜单 。 


获取 帮助 


Android Studio 中 的 帮助 菜单 有 几 个 有 用 的 菜单 项 。 查 找 操作 ( ctrltSshift+A|Cmd+Shift+A ) 
是 Android Studio 中 用 的 最 多 的 获得 帮助 的 命令 。 这 个 命令 行 会 激活 一 个 对 话 框 ， 允 许 你 搜索 
Android Studio 中 的 任何 东西 。 按 下 ctrl+shift+A|cmd+shift+A 并 且 在 搜索 框 中 输入 Show Line 
Numbers， 然 后 使 用 足 标 选 择 Setting 然 后 按 下 Enter。 在 设置 禄 口 ， 选 

择 Editor > Appearance 。 ( 译 者 注 : Android Studio 是 Editor>General>Appearance ) 。 接 着 
你 就 能 看 到 Show Line Numbers 的 复 选 框 了 。 


选择 Help>online Documentation ,你 能 够 看 到 Android Studio 中 的 所 有 技术 规范 文档 资源 。 这 
是 Android Studio 最 全 面 的 文档 。 同 时 ， Help>Default Keymap Reference 菜单 项 也 是 一 个 非常 
有 用 的 参考 。 你 可 以 考虑 将 PDF 文 档 打 印 出 来 ， 然 后 在 你 学 习 使 用 Android Studio 的 时 候 放 在 
手边 时 时 参考 。 


导航 快捷 键 


快捷 键 是 最 强大 的 方式 来 浏览 Android Studio。 在 主 菜 单 栏 选择 Navigate 菜 单 浏览 其 内 容 。 本 
节 将 讨论 一 些 重要 的 菜单 项 (如 表 2-3) 及 其 对 应 的 导航 菜单 快捷 键 。 随 后 的 章节 讨论 其 他 的 


菜单 项 。 


表 2-3 导航 快捷 键 


Command PC Keys Mac Keys 


elect Im Alt+F1 Alt+F1 

Class Ctrl+N Cmd+0 

File Gtrlitoshift+N Cmd+Shift+O 

Line GtrltG Cmd+L 

Related File Ctrl+Alt+Home Alt+Cmg+Up-Arrow 
Last Edit Location Gtrliroshift+Backspace Cmd+Shit+Backspace 
Type Hierarchy Ctrl+H Gtrli+H 

Declaration Ctrl+B Cmd+B 


选择 在 


Android Studio 最 好 的 特性 之 一 是 导航 是 双边 的 。 你 已 经 见识 过 如 何在 各 种 工具 窗口 中 作为 编 
辑 器 的 选项 卡 来 打开 /激活 文件 。 现 在 你 将 要 学 习 如 何 从 编辑 器 中 导航 到 各 种 工具 窗口 。 


按 下 Alt+F1 。 激 活 选 择 上 下 文 菜单 ， 其 中 包含 几 个 菜单 项 ， 包 括 项 目 视 图 ， 收 藏 和 文件 结构 
等 。 点 击 项 目 视图 操作 。 项 目 工 具 窗 口 将 会 激 洁 ， 文 件 对 应 的 编辑 器 中 活动 的 选项 卡 将 会 高 
毫 显 示 ， 并 且 该 文件 的 父 目录 将 会 自动 打开 。Android 项 目 中 有 很 多 的 资源 文件 ; 因此 ， 会 用 
对 操作 是 最 重要 的 熟练 技能 之 一 。 


类 操作 允许 你 导航 到 一 个 特定 的 java 类 。 值 得 重点 关注 的 是 这 个 操作 只 能 查找 Java 资 源 文件 
或 是 Java 资 源 文件 的 内 部 类 。 按 下 ctrl+N|cmd+t0 然后 开始 输入 act 。Android Studio 将 检索 
你 所 有 的 文件 ， 并 且 提 供 可 能 匹配 的 列表 ， 将 最 可 能 匹配 的 高 完 显 示 。 你 只 需要 按 

下 Enter 来 打开 MainActivity.java ° 


文件 


文件 操作 允许 你 导航 到 项 目 中 的 任何 文件 。 如 果 你 想 查 找 你 项 目 中 的 Xml 文件 ， 那 么 你 将 用 这 
个 操作 。 按 下 ctrLl+shift+N|Cmd+Shift+0 然后 输入 act 。 我 们 故意 使 用 了 相同 的 检索 项 来 说 
明 Navigate>File 中 的 更 广泛 的 范围 。 可 以 注意 到 搜索 结果 中 包含 Java 资 源 文 

件 MainActivity.]Jjava 和 一 些 其 他 的 文件 ， 如 activity main.xml] ° 用 鼠标 来 选 

择 activity_main.xml 然后 按 下 Enter 键 来 打开 ° 


行 


使 用 Ctrl+G|Cmd+L 来 执行 行 操作 ’ 会 激活 一 个 对 话 窗 口 ’ 然后 以 Line:Column 形 式 导 航 到 你 
的 资源 文件 。 如 果 你 在 Go to Line 对 话 框 中 输入 一 个 简单 的 整数 然后 点 击 OK ，Android Studio 
年 会 跳 转 到 指定 的 行 而 不 管 列 。 


相关 文件 


按 下 ST Hon A 头 来 打开 相关 文件 夹 操 作 是 Android Studio 中 一 个 非常 有 用 的 
命令 行 。Android 项 目 通 常 有 一 个 非常 多 的 相关 文件 。 例 如 ， 一 个 简单 的 Android Activity 通 
常 有 至 少 一 个 相对 应 的 Xml 布局 文件 来 呈现 SEE 的 布局 ， 和 一 个 相对 应 ME 1 
来 呈现 Activity 的 菜单 。 如 果 你 使 用 Fragments， 这 只 会 增加 复杂 性 。 你 已 经 知道 
Favorites 如 何 组 织 相关 文件 。 Navigate >Related File 中 ， 你 可 以 看 到 Android ee 
给 你 的 相关 文件 。 打 开 MainActivity.java 选项 卡 ， 按 下 Ctrl1L+A1Lt+Home|AlLt+Cmd+ 上 箭头 。 你 应 
该 能 够 看 到 activity_main.xml 列 出 来 了 。 使 用 鼠标 来 选择 然后 按 下 Enter 。 


芭 后 编辑 位 置 


按 下 ctrl+shift+Backspace|Cmd+Shift+Backspace 激活 最 后 编辑 位 置 ， 这 个 位 置 允 许 你 导航 到 最 
后 的 编辑 位 置 。 如 果 你 继续 激活 这 个 命令 ， 你 的 鼠标 将 会 移动 到 之 前 编辑 的 文件 /位 置 ， 等 


大 大 


村 O 


类 型 层级 结构 


Android 使 用 的 是 面向 对 象 的 编程 语言 Java。 面 向 对 象 语 言 的 最 大 特点 之 一 是 继承 ， 它 促进 了 
代码 的 重用 和 多 态 4 性 。 在 编辑 辑 芜 玩 中 打开 MainActivity.]Jjava 文件 ， 按 下 ctrl+H 来 切换 打开 层 
次 结构 窗口 。 在 打开 的 窗口 你 将 看 到 一 系列 的 层 悟 对象， 所 有 的 对 象 都 可 以 追溯 到 祖先 的 在 
Java 中 被 称 作对 象 的 所 有 对 象 。 需 要 记 住 的 是 只 有 在 编辑 器 中 打开 的 是 Java 资 源 文件 的 

话 Navigate >Type Hierarchy 才 可 以 激活 。 


声明 


声明 操作 允许 你 跳 转 到 原始 的 定义 方法 、 变 量 和 资源 。 激 活 这 个 操作 的 另 一 种 方式 是 按 

住 ctri|cmd 然后 在 文件 中 的 方法 ， 变 量 或 资源 文件 上 滚动 鼠标 。 如 果 这 个 元 兹 上 有 下 划 线 ， 

你 可 以 通过 单 击 导航 到 它 的 声明 上 。 在 MainActivity.java 中 ， 点 击 方法 setcontentView 中 的 
任何 地 方 然后 按 下 ctrl+B|lcmd+B 。 你 将 会 立即 跳 转 到 该 方法 的 声明 ， 它 位 于 MainActivity 的 


超 类 ActionBarActivity.Jjava 中 , 


查找 和 替换 


查找 和 替换 文本 是 编程 的 一 个 重要 部 分 ，Android Studio 有 一 套 强 大 的 工具 来 帮助 你 做 到 这 一 
点 。 本 节 讨 论 一 些 最 重要 的 工具 。 如 表 2-4 上 所 列 。 


表 2-4 查找 和 替换 


Command PC Keys Mac Keys 
Find Ctrl+F Gmd+F 

Find In Path Gtrlirshitt+F Gmd+Shift+F 
Replace Ltrl+R Gmd+R 
Replace In Path Gtrl+Shitt+R Gmd+Sshift+R 


查找 


查找 操作 用 于 查找 在 本 文件 中 的 文本 。 。 在 MainActivity.]Jjava 中 ， 按 下 Ctrl+F|Cmd+F 在 编辑 让 如 
的 最 上 方 弹出 一 个 搜索 栏 。 在 搜索 栏 中 输入 action ， 你 将 注意 到 | 文件 中 会 0 
示 。 你 也 可 以 在 标记 栏 上 看 到 一 些 绿色 的 标记 用 来 标记 查找 到 的 文本 的 位 置 。 将 鼠标 移 到 查 
找 栏 的 双 右 箭头 上 将 会 显示 高 级 搜索 选项 。 


局 己 
给 


径 中 查找 


eho 比 之 前 讲 的 查找 操作 查找 的 范围 更 广泛 的 范围 。 你 也 可 以 使 用 正则 衣 达 式 和 界 
定 文 件 履 盖 的 结果 。 按 下 ctrl+shift+F|cmd+Sshift+F 并 且 在 搜索 框 中 输入 hello 。 默 认 情 况 
下 ， 搜 索 范 围 被 设置 为 整个 项 目 ， 但 是 你 可 以 限制 搜索 范围 到 一 个 特殊 的 目录 或 是 module 。 
同意 整个 项 目的 默认 设置 并 且 点 击 查 找 按钮 。 结 果 将 会 显示 在 查找 工具 窗口 。 点 击 查找 窗口 
中 的 一 个 条 目 将 会 立即 将 关闭 的 文件 打开 为 编辑 器 中 一 个 新 的 选项 卡 并 且 跳 转 到 搜索 的 地 方 
和 8 


替换 


通过 ctrl+R|cmd+R 打开 替换 操作 ， 这 个 操作 用 于 替换 当前 文件 中 的 文本 ， 并 且 和 替换 功 能 是 查 
找 的 超 集 。 替换 文本 和 最 安全 的 方法 就 是 使 用 Refactor>Rename 命令 ， 稍 后 我 们 将 介绍 它 。 


径 中 替换 


通过 ctrl+Shift+R|Cmd+Shift+R 打开 在 路 径 中 替换 操作 ， 这 个 操作 是 在 路 径 中 查找 的 超 集 。 然 
而 ， 使 用 Refator>Rename 会 比 在 路 径 中 替换 更 好 ， 因 此 ， 当 你 引入 错误 的 时 候 你 将 及 其 谨 懂 
的 使 用 这 个 命令 。 


巡 疆 


AN -一 只 


Ct 


在 本 草 中 ， 我 们 讨论 了 编辑 器 和 编辑 器 周围 的 工具 窗口 。 我 们 讨论 了 如 何 使 用 工具 按钮 和 将 
他 们 重 定 位 。 我 们 也 讨论 了 包括 主 菜 单 栏 ， 工 具 栏 ， 状 态 栏 ， 边 栏 和 标记 栏 的 用 于 导航 的 工 
具 窗 口 和 主要 的 UI 元 素 。 我 们 也 讨论 了 如 何 去 搜索 和 通过 使 用 菜单 栏 和 快捷 键 来 导航 ， 以 及 
使 用 查找 和 替换 。 和 最后， 我 们 讨论 了 Android Studio 中 怎样 使 用 帮助 系统 。 更 重要 的 是 ， 我 们 
已 经 在 Android Studio 中 建立 了 一 个 UI 元 素 ， 这 些 我 们 将 在 后 续 章 节 中 引用 。 
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译 者 : keyoo 
来 源 : Learn Android Studio 汉化 教程 第 三 章 : 使 用 Android Studio 编程 


本 草包 含 如 何在 Android Studio 中 书写 或 生成 代码 。 Android Studio 使 用 面向 对 象 编程 的 思想 
来 生成 极其 相关 的 和 格式 规范 的 代码 。 本 草 的 特色 体现 在 重 载 方法 ，Java 块 的 包围 语句， 使 
用 模板 播 入 代码 ， 自 动 补 全 ， 注 释 代 码 和 移动 代码 ， 如 果 你 读 这 本 书 的 目标 是 要 精通 Android 
Studio， 那 么 你 需要 密切 关注 这 草 ， 因 为 所 描述 的 工具 和 技术 将 在 你 的 编程 效 举 发 挥 最 大 的 作 
用 。 让 我 们 开始 吧 ， 若 是 在 第 一 章 创建 的 Helloworld 应 用 程序 还 没有 打开 ， 请 前 往 打 开 。 


代码 折 熙 是 一 种 在 编辑 器 中 保存 屏 幕 实际 使 用 空间 的 方式 ， 代 码 折 滞 允 许 你 去 隐藏 特定 代码 
块 以 便于 于 你 可 以 充分 地 集中 注意 力 在 你 感 兴 趣 的 代码 块 上 ， 如 采 MainActivity.]Jjava 没有 打 
开 ， 按 ctrl+N | Cmd+0 并 输入 Main ， 按 Enter 键 打开 MainActivity.Jjava 的 类 ， 如 图 3-1 








图 3-1 使 用 输入 类 名 对 话 框 来 打开 MainActivity.java 


如 果 行 号 默认 没有 显示 ， 导 航 到 Help > Find ， 输 入 show line numbers 并 且 勾 选 Show Line 
Numbers Active Editor 这 一 项 ， 如 图 3-2. 





Show Line Numbers van te 


Show line numbers Settings 


图 3-2 使 用 输入 Action 或 者 选项 名 对 话 框 来 显示 行 号 


正如 你 在 MainActivity.java 中 所 观察 到 的 行 号 ， 你 将 会 注意 到 一 些 奇 怪 的 情况 : 行 号 不 是 连 
续 的 ， 在 图 3-3 中 ， 行 号 从 1,2,3 开 始 ， 然 后 就 跳跃 到 7,8,9 了 ， 仔 细 观 察 图 3-3 的 第 3 行 ， 你 会 发 
现 这 里 在 import 语句 的 左边 有 一 个 包含 了 + 的 方块 ， 同 时 随后 是 省 略 号 ， 如 果 你 仔细 观 勾 
你 的 代码 ， 你 也 会 注意 到 这 个 省 略 号 用 浅 绿色 高 完 显 示 ， 这 些 可 见 的 元 杀 提 示 你 Android 
Studio 正隆 藏 被 折 三 的 代码 块 


】 package com.apress.gerber.helloworld:; 

2 

3 Himport ... 

1 

8 

9 i public class MainActivity extends ActionBarActivity { 
10 
11 BOverride 
12i:8| protected void onCreate (Bundle savedInstanceStatce) | 
13 Super.onCreate (3avedInsatanceState):; 
0| | setContentView (R.layout .activity main) ;| 

15 白 } 

16 


图 3-3. 在 import 语句 的 折 司 代码 块 


位 于 左边 留 空 处 是 折 和 三 边框 形成 的 细 虚 线 ， 同 时 介 于 灰色 留 空 与 白色 编辑 器 之 问 ， 折 三 边框 
包 念 了 三 个 图 标 :位 于 小 方块 的 内 部 + 号 (正如 图 3-3 的 第 3 行 ) 和 有 着 水 平 线 在 里 面 的 上 下 得 
头 ， 向 下 的 将 头 表 名 是 一 个 可 折 申 代码 块 的 开始 部 分 ， 同 时 向 上 箭头 指示 它 的 结束 部 分 ， 上 
文 提 到 的 + 号 ， 表 明 某 个 代码 块 已 经 被 折 生 了 ， 点 击 这 些 图 标 中 的 任意 一 个 将 会 切换 对 应 代 
码 块 为 折 晤 还 是 打开 状态 ， 表 3-1 包 含 了 代码 折 有 司 操 作 的 描述 和 快捷 键 。 


Tatle 3-1. Code Folding Options 

Option PC Keys Mac Keys Description 

Expand Ctrli+Numeric-Plus cmd+Numeric-Plus Expands the collapsed block 
Where your cursor is located 


Collapse Ctrl+Numeric-Minus Cmd+Numeric-Minus Collapses the expanded block 
Where your cursor is located 


Expand Al Girirshift+Numeric-Plus Gmd+eshift+Numeric-Plus Expands all code in a window 


Gollapse All Girirshiftf+Numeric-Minus Gmd+rshiftf+Numeric-Minus Gollapses allthe cods In a 
Window 


Toggle Fold Gtri+Period Gmd+Period Collapses/expands the block 
Where your cursor is located 


把 你 的 光标 放 在 MainActivity .Jjava 的 onCreate() 方法 中 ， 现 在 长 

按 ctrl+Period | Cmd+Period 来 切换 他 的 代码 块 展开 或 折 蜗 》 瑟 外 ， 也 可 以 用 快捷 
键 Ctrl1+ 数 字 键 "+" 或 者 cmd+ 数 字 键 "+" 展开 代码 、 也 可 以 用 快捷 键 ctr1+ 数 字 键 "-" 或 
者 cmd+ 数 字 键 "-" 折 党 代码 。 


总 之 通过 点 击 在 折 晤 边框 内 的 代码 折 党 图 标 折 党 /展开 你 的 代码 块 ， 记 住 ， 折 党 单个 块 ， 多 个 
块 ， 或 一 个 文件 的 所 有 块 ， 是 为 了 节省 屏幕 空间 从 你 的 视线 中 删除 了 ， 然 而 当 你 bulid 的 时 
候 ， 编 译 器 仍然 会 编译 他 们 。 类 似 的 ， 折 熙 一 个 包含 了 问题 的 、 有 错误 的 代码 的 块 将 不 会 从 
标示 条 删除 任何 警告 或 者 出 错 。 你 若 要 改变 代码 折 和 党 的 选项 ， 请 选择 通过 菜单 选 线 进 


入 Settings > Editor > Code Folding . 


使 用 代码 补 全 


现代 大 多 数 编译 器 都 会 提供 一 些 代 码 补 全 的 格式 ，Android Studio 也 不 例外 ，Android Studio 
乐意 帮助 ， 就 算 你 不 主动 去 寻求 帮助 ， 实 际 上 ，Android Studio 将 为 你 各 种 各 样 的 的 默认 提醒 
来 随 着 你 的 输入 完成 你 的 代码 。 这 些 Android Studio 自 动 生 成 的 默认 提醒 列表 可 能 是 不 完美 
的 ， 但 是 这 些 提 醒 是 根据 最 佳 实践 得 到 来 设置 的 ， 并 且 它 们 通常 遵循 很 好 的 命名 规则 。 
Android Studio 可 以 很 好 地 理解 Android SDK 和 java 程 友 设 计 语 言 ; 事实 上 ， 它 可 能 知道 那些 
问题 ， 远 和 远 超 过 你 所 知道 的 ， 如 果 你 以 说 懂 和 热忱 的 心态 学 习 这 个 工具 的 使 用 ， 你 最 终 将 会 
看 起 来 想 一 个 摇滚 歌手 ， 不 管 你 的 之 前 的 编程 经 验 是 什么 。 这 个 代码 补 全 的 特点 是 对 上 下 文 
敏感 的 ， 在 此 条 件 下 ， 这 些 补 全 根据 你 的 光标 所 在 的 范围 来 提供 给 你 不 同 的 提醒 ， 比 如 ， 你 
正在 键入 一 个 类 范围 内 的 代码 ， 内 键入 的 代码 ， 即 
使 你 选择 不 接受 这 个 代码 补 全 提醒 ， 基 于 上 述 理由 ， 需要 注意 他 们 。 


表 3-2 列 出 了 4 种 在 Android Studio 中 的 代码 补 全 : 


e 尔 键入 代码 ， 上 默认 的 代码 补 全 功能 会 自动 启 作用 

. 基本 的 代码 补 全 不 仅 扮 演 着 类 似 于 默认 代码 补 全 的 功能 ， 还 在 提醒 列表 中 的 当前 选项 的 
沈 边 展示 了 一 个 Javadoc 的 窗口 

e 精妙 的 代码 补 全 同时 扮演 者 Javadoc 的 功能 之 外 ， 还 有 生成 一 个 更 敏感 的 相关 的 提醒 列表 

e。 循环 地 扩展 单词 环 ， 允 许 你 选择 在 已 用 过 的 源 代 码 单词 


lable $2. Code-GCompetion Optiions 
Option PC Keys Mac Keys Description 


Default None None Default code-completion behavior. 
Android Studio displays a suggestion 
list next to YOUr cursor as YOU type. 
YDU can use your up- and down-arrow 
Keys to navigate among entries in the 
suggestion list, and the Enter key to 
select an entiry. 


Basic Ctrl+Space Ctrl+Space Basic code completion functions 
IIKe Default code completion, but 
also displays the Javadoc window 
next to the currently selected entry. 
Clicking the up-arrow icon in the 
Javadoc window displays detailed 
documentation. 

smartType Ctrl+Shift+Space Ctrl+Shift+Space SmartType code completion functions 
like Basic, but generates a more 
selective and relevant suggestion list. 


Cyclic Expand Alt+r/ Altr/ Offers words already Used in your 
Word document. Cycles up. 
Cyclic Expand Alt+Shittr Alt+Shift+? Offers words already used in your 


Word (Backward) document. Cycles down. 
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让 我 们 开始 编码 来 演示 代码 补 全 是 怎么 工作 的 ， 在 包 com.apress.gerber.helloworld 右键 (Mac 
中 是 ctrl - 单 击 )， 并 选择 New > Java class 来 创建 新 的 类 对 话 框 ， 如 图 3-4 所 示 ， 吧 这 个 类 
命名 sandbox 并 点 击 OK 





创建 新 的 类 对 话 框 


Sandox.java 的 Sandbox 类 的 大 括号 内 部 ， 定义 一 个 私有 变量 ， 如 图 3-5， 一 个 代码 补 全 的 菜 。* 
出 现 了 ， 并 列 出 了 可 能 的 选择 帮 你 完成 你 的 哆 吗 ， 使 用 上 下 箭头 键 来 导航 代码 补 全 的 菜单 ， 
使 用 下 键 选择 List<E> 这 个 选项 并 回 车 。 


[a public class Sandbox 上 

7 

8 | private Li 

9 } 全 |) 在 Linked8ashMap <H, 
10 LinkedHashSet<E> (java.ucil 





国 | 让 ListIterator <E; [UE 

© ListRhesourceBundle (java.util 

写 LinkageError Land 

全 | 在 LinkedBLockingDeque<E> [java.util.concurrent 
Eb LinkedBlockingQueue <E 

Ob LineMumberReader (java.ic 


站 i Ee Ei Me my oP ss 二 
Press 全 村 用 本 站 村 to choose the Seteted [of et 3 全 可 站 SG 站 本 几 


图 3-5. 当 你 开始 输入 的 时 候 出 现 的 一 个 代码 补 全 的 菜 。 


Android Studio 的 默认 行为 是 当 你 开始 键入 时 ， 出 现代 码 补 全 提醒 列表 ， 你 不 需要 激活 任何 快 
捷 键 来 调用 这 个 默认 的 代码 补 全 一 一 他 是 自动 出 现 的 。 你 应 该 现在 有 一 行 私有 List 的 代码 ， 如 
图 3-6， 直 接 跟 随 这 个 单词 列表 ， 键 入 左 尖 括号 用 以 定义 在 java 中 的 泛 型 ， 注 意 Android Studio 
关闭 了 括号 语句 用 封闭 的 右 尖 括号 ， 并 把 你 的 光标 置 于 括号 中 
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F re 和 省 Pa < Android AFI19 Platiorm = 器 
Serieriarh , 
Bb scringBuffer puble final chss 
I StripgBuilder String 


i SrineInderNeirmndisEncept lon 
和 1 怕人 ds 癌 bie 
Sh Ere : 


上 看 要 直下 臣 古 于 证 疡 工 堪 训 机 克 忆 可 医 下 后 二 夺 起 攻 后 而 
下 向 和 总 工 世 二 在 工 白 基 记忆 二 亏 色 王 
上 而 二 二 ee 


Ei 2 


图 3-6. 字符 串 作 为 泛 型 的 列表 的 代码 补 全 


在 从 括号 的 Str 类 型 ， 按 下 ctrl+Space 调用 基本 代码 补 全 功能 。 你 将 会 注意 到 一 

个 string 的 Javadoc 窗 口 的 文档 在 提醒 列表 中 出 现 当 前 选中 项 ( string ) ， 滚 动 Javadoc 窗 
口 可 以 看 到 对 String ea ， 点 击 向 上 箭头 ，Javadoc 窗 口 将 展示 出 详细 

的 string API 文 档 在 你 的 默认 浏览 颖 ， 返 回 Android Studio 并 选择 string 作为 泛 型 类 ， 你 
将 会 使 用 的 ， 按 Enter 键 定义 出 List<String> 。 


Android Studio 的 特色 之 一 是 它 会 为 你 提醒 变量 名 ， 直 接 键 入 一 个 空格 后 ， 私 有 

List<String> 通过 按 Ctr+ 空 格 出 现 基 本 的 基本 代码 补 全 ，Android SEE ， 
但 是 上 述 变量 名 都 不 足 于 描述 ， 因 此 只 能 键入 mGreetings 。 人 小 写字 母 m py ( 即 

域 ) ， 把 类 的 成 员 名 用 m 作为 前 组 在 Android 中 是 一 种 命名 约定 。 同 样 的 ， 静 态 类 成 员 用 小 写 
字母 s 作为 前 级， 你 不 需要 遵循 这 种 命名 约定 ， 但 是 pe 
循 了 ， 记 住 局 部 变量 (方法 作用 域内 ) 不 允许 用 m 和 s 作为 前 级 约定 ， 修 改 你 的 代码 行 

为 List<String> mGreetings = new 。 按 ctrltShift+Space 调用 智能 代码 补 全 ， 选 

择 ArrayList<>() aa ， 还 包含 了 终止 的 分 号 ， 如 图 3-7， 类 似 于 基本 代码 补 全 ， 在 生成 

提醒 列表 的 时 候 ， 还 比 默认 的 和 基本 代码 补 全 范围 增多 了 ， 上 比如 ， 当 使 用 智能 代码 补 全 在 赋 

值 操作 的 右边 ， 提 醒 列表 通 第 包含 了 相关 的 工厂 方法 。 


注 : 如 果 你 的 在 Android Studio 的 JDK 版 本 是 7 或 者 更 高 ， 通 过 代码 补 全 的 生成 的 代码 可 能 是 
用 菱形 标记 ， 比 如 ， 在 使 用 泛 型 的 赋值 语 负 来 定义 的 右边 ， ArrayList<String> 可 能 出 现 
为 ArrayList<> ° 


di af 


la 


15 Yefactor 1nitiali2atio0n to constructr 


16 private List<Stringy mGreetings = new ArrayList<String>(): 


19 
20 


图 3-7 智能 代码 补 全 


循环 扩展 词 是 一 个 花哨 的 名 字 ， 但 是 它 实际 上 非常 简单 。 调 用 循环 扩展 词 只 需 按 下 Alt 键 ， 

同时 按 住 / 键 几 秒 钟 ， or 共 你 同样 的 单词 ， 他 们 都 曾 出 现在 你 的 文档 里 ， 由 于 你 
的 循环 遍历 这 些 单词 ， 注 意 黄色 高 完 部 分 ， 现 在 调用 循环 扩展 词 ， 长 按 Alt + Shift +"/" ， 

注意 到 提供 并 高 亮 的 单词 现在 向 下 远离 你 的 光标 ， 而 非 向 上 远离 。 


注释 代码 


如 果 你 已 经 完成 了 所 有 的 编码 工作 ， 你 了 解 和 到 ， 有 些 代码 行 是 一 些 注释 ， 将 会 被 编译 器 忽 
略 ， 但 是 包含 了 信息 或 者 元 数据 ， 数 据 是 非常 重要 的 ， 对 于 编码 者 和 协同 编码 者 ， 注 释 可 能 
是 行 注 释 ， 以 // 开始 ， 也 可 能 是 块 注释 ， 以 / 开始 ， 以 / 结束 ， 从 主 菜单 可 以 看 出 ， 你 可 
以 激活 注释 ， 只 需 选 择 code > Comment ， 然 而 ， 最 好 的 方法 是 通过 快捷 键 来 截获 ， 如 表 3-3 所 
pi 


Table 3-3. Gommenting Optons 

Option PC Keys Mac Keys Description 

Toggle Comment Line Ctrir Cmd+r Toggles a line between comment or 
uncomment using Java line comment style 
[8.9., /7 ...) You may apply this action to more 
than one line by selecting those lines. 


Toggle Gomment Block Gtrirshiftr: Alt+GmMmd+: -Toggles selected text between commented 
block or Uncommented block using Java 
block comment style, such as / ... *. 
Applying a comment block to selected 
text will include all ithe selected text im the 
comment block. 


类 型 重 构 初始 化 被 构造 ， 并 放 在 mGreetings 声明 的 上 面 ，Cctrl+/ | cmd+/ 把 其 转化 为 注释 ， 
如 图 3-7， 在 开启 和 关闭 注释 切换 实验 ， 只 需 使 用 快捷 键 ctrl+t/ | cmd+/ . 


使 用 代码 生成 


恰当 的 使 用 代码 生成 功能 ， 这 一 特色 将 为 你 节约 大 量 的 时 间 ， 代 码 生 成 是 生成 各 种 方法 的 的 

"0 月 已 ， 包括 了 构造 ” getters ， setters ，eduals() ， hashcode() ， toString() ,方法 等 
。 在 你 使 用 代码 生成 之 前 ， 确 认 Android Studio 是 配置 好 了 ， 可 以 忽略 成 员 名 称 的 前 级 ， 如 

机 ， 点 击 File > Settings > Code Style > Java > Code Generation 将 得 到 设置 对 话 框 ， 将 

会 出 现代 码 生成 的 标签 页 ， 如 果 域 和 况 坊 域 文本 框 不 包 会 a 和 s ， 则 键入 他 们 并 点 击 " 应 

用 “和 ”确定 *， 如 图 3-8. 
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Tabs and Indents | Spaces | \Wrapping and Braces | Blank Lines | JavaDoc | Imports | Arrangement Ode ver 


Naming crder of llembers 





[| Prefer longer narmes 


Fu Instance field 
Name prefic Name suffie a 4 
Constructors 


Field: | | gtaticmethods 
Static Inmer elasses 


Final Modifier 
[| Make generated local variables final 


| Make generated parameters final 


图 3-8 加 入 m 和 s 到 代码 生成 标签 页 的 域 和 静态 域 


器 


构造 器 


把 你 的 光标 放 在 Sandbox.java 的 类 汇 围 中 。 为 了 在 Android Studio 生 成 一 个 构造 贤 ， 

按 Alt+Insert | Cmd+N 并 选择 constructor ， 那 么 选择 的 域 被 构造 对 话 框 初始 化 ， 如 图 3-9 ， 
选择 类 成 员 作 为 参数 。 我 们 非 参 数 构 造 器 ， 因 此 点 击 None 这 个 按钮 。 在 Java 中 ， 是 很 常见 
的 ， 就 是 重 载 构造 器 ， 通 过 不 同类 型 的 参数 和 不 同 数 量 的 参数 ， 比 如 ， 你 可 以 调用 这 个 对 话 
框 来 生成 一 个 带 List<String> 参数 的 构造 器 2 并 且 为 成 员 变量 mGreetings 赋值 。 
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A 


第 三 章 : 使 用 Android Studio 编程 


T Cc com.apress.gerber.helloworld.app.Sandbox 
I 6 m6reetings:List< String> 





通过 构造 对 话 框 来 选择 要 初始 化 的 域 。 


EE 


Getters/Setters 


Java 类 通 第 是 封装 好 的 ,这 意味 着 类 成 员 通 常 声 明 为 私有 的 ,并 且 访 问 这 些 成 员 的 公共 接口 是 通 
过 公有 访问 器 ( getter ) 和 公有 修改 器 ( setter ) 方 法 爱 提 供 的 。 在 sandbox.java 类 域 范围 内 点 
击 你 的 和 鼠标。 并 且 按 Alt+insert ( cmd + N ) 。 你 会 注意 到 有 一 个 选项 是 Getter ,一 个 

为 setter ， 还 有 Getter 和 setter 的 组 合 。 Getter 和 setter 方法 一 般 都 是 成 对 出 现 的 , 除 
非 你 有 一 个 很 好 的 理由 要 省 略 其 中 一 个 或 着 另 一 个 ,否则 最 好 是 生成 后 面 的 组 合 选 项 。 从 列表 
中 选择 Getter and Setter 如 图 3-10 所 示 。 在 随后 的 选择 字段 生成 getter 和 setter 对 话 框 中 ， 
从 列表 中 选择 mGreetings:List<string> 列表 并 点 击 OK。 你 的 类 现在 为 变量 mGreeting 有 

了 getter 和 setter ,如 图 3-11。 请 注意 ,生成 的 代码 忽略 了 m 前 级 ， 在 生成 方法 名 称 的 时 候 ， 

因为 你 在 之 前 的 设置 中 把 m 和 s 设置 为 了 前 级 。 
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Constructor 
Getter 

>etter 和 
better and Setter 


equals() and hashCodel 
toString( 

Override Methods,.. 
Delegate Methods,,. 
Copyright 


生成 访问 器 和 修改 器 


i 


lsd 


‘public class Sandbox 1 


et my 下 yp 
-r-relactor iniLialiZation to constructor 


private List<String> mbreetings = new ArrayList<String>(); 


public Sandbox() I 


public List<String> getGcreeting3() 1 
return moreetings;: 


BUblicC Void setGreetings (List<Stringy greetings) 1 
mGreetings = greetings:; 


生成 访问 器 和 修改 器 方法 


方法 重 载 
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代码 生成 是 理解 类 继承 结构 的 ,所 以 你 可 以 覆盖 包含 在 任何 父 类 或 接口 实现 的 广 
法 。 sandbox.java 是 一 个 简单 的 普通 java 对 象 (POJO)。 现 在 你 修改 sandbox 类 来 继 
承 Rectshape 。 当 你 输入 继承 Rectshape 时 ,这 个 词 Rectshape 可 能 以 红色 突出 显示 。 如 果 适 


合 你 需要 的 情景 , 按 Alt + Enter 来 导入 Rectshape 类 ,如 图 3-12 所 示 


a 
10 import android.graphics. drawabDle. shapes. Rectohape:; 
11 import Java. util.ArravyList:; 
12 Cimport Java. ucil.List; 
13 
14d public class Sandbox extends RectShape { 
15 
继承 超 类 


如 果 你 通过 按 ctrl+H 调用 了 层次 结构 视图 ,您 将 看 到 带 有 RectShape 的 Sandbox 的 类 层次 结 
构 ，shape ,和 object 作为 它 的 祖先 ,可 以 通过 观 稍 图 3-13， 你 可 以 明白 。 现 在 

按 Alt +Insert | cmd + N 并 选择 复 盖 方法 。 让 我 们 重 写 shape 的 hasAlpha() 方法 ,如 图 3 - 14 
所 示 。 日 java 5 版 本 开始 的 约定 : 要 用 @override 来 注解 想 和 覆盖 的 方法 ， 我 们 选 

中 @override 复 选 框 并 插入 。 @override 注解 告诉 编译 器 来 验证 方法 的 名 字 和 签名 ,以 确保 该 
方法 事实 上 已 被 徐 盖 。 修 改 hasAlpha() 的 返回 值 为 true 。 
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Wb draw(canvas:Canvas, paint:Paint):void 
WF onResize(width:float, heightfloat):void 
(Wb clone0:RectShape 

页 android.graphics.drawable.shapes.Shape 


hasAlpha():poolean 
v (Cjava.lang.Object 
(mb equals(o:Object):boolean 
MF finalize0'void 
(Wb hashCode(:int 
四 b toString0:String 





| Copy JavaDoc 


在 RectShape 中 选择 要 敌 盖 /实现 的 方法 








32 :|  eoverride 
33 所 | 口 public boolean hasAlpha(l) { 
34i | | return true; 


35: [A } 


修改 hasAlpha( ) 方法 


toString( ) 方法 


Android Studio 可 以 为 你 生成 tostring() 方法 。 让 我 们 为 sandbox 创建 一 个 tostring() 方法 ， 
同时 也 包括 mGreetings 成 员 。 按 Alt +tInsert| cmd + N 并 选择 tostring() 。 选 择 你 的 唯一 成 
mGreetings ,并 单 击 OK。Android Studio 生 成 一 个 返回 字符 串 ， 

如 “Sandbox{“+”mGreetings = " + mGreetings +4′ ,如 图 3-15。 如 果 在 类 中 有 多 个 成 员 ,可 选择 

他 们 ,他 们 也 会 被 附加 到 这 个 方法 的 返回 字符 串 。 当 然 tostring() 方法 生成 的 代码 并 不 是 一 成 
不 变 的 ,这 个 方法 是 可 以 改变 为 任何 你 想 要 的 ,只 要 它 返 回 是 一 个 字符 串 。 


员 





村“ 


37 EOverride 

8:@| 口 Public String toSstring() 1 

}9 return "Sandbox{" + "mGreetings=" + mGreetings + '}': 
10 器 | 


1 1 


图 3-15 生成 tostring() 方法 


委托 方法 


Android nd 的 类 成 员 , 从 而 允许 您 pg 方法 中 定义 类 方法 的 类 成 员 。 
这 听 起 来 很 复杂 ,但 它 很 容 男 。 为 了 给 你 展示 委托 方法 的 选择 是 如 何 工 作 的 ,让 我 们 转 到 代码 中 

来 看 。 在 Sandbox,]java ， 把 你 的 光标 放 在 类 范围 内 。 按 Alt +Insert | Cmd + N ,然后 选择 

Delegate Methods。 选 择 rp 一 并 按 下 OK。 列 表 接 口 有 很 多 方法 ,你 都 可 

以 委托 行为 。 为 简单 起 见 ,选择 添加 (object:E):boolean ,如 图 3-16。 如 果 你 想 委 托 多 个 方法 ,在 
选择 这 些 方法 的 时 候 ， 及 全 ctrl 键 ( cmd 键 在 Mac)， 单 击 OK。 


443 口 public boolean addlString object) 1{ 
各 旦 return mGreetings.add (obiject): 
45: 白 ) 

所 

选择 要 生成 委托 的 方法 


在 sandbox.java 中 生成 的 add() 方法 现在 是 一 个 代理 ， 代 表 mGreetings 成 员 行 为 

的 add() 方法 。 如 图 3-17 所 示 。 注 意 到 add() 方法 的 参数 是 定义 为 一 个 string 来 匹 

配 mGreetings 的 泛 型 定义 , List<string> 。 委 托 方 法 并 不 履 盖 方法 ,所 以 您 可 以 随意 重 命名 你 
的 代理 方法 ,但 这 个 名 字 add() 很 有 意义 ,所 以 尽 可 能 保留 这 个 名 字 。 
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java.util,List 
Db add(llocation:int, object:E):void 
加 add(object:E):boolean 
| Db addAll(location:int, collection:Collection<? exten 
| 加 addAll(collection:Collection<? etends E>):boole 
“Db clear0'void 
Tr contains(object:Object):boolean 
加 和 containsAll(collection:Collection<?>):boolean 
Db equals(object:Object):boolean 
bb get(location:int}:E 
Db hashCodel:int 
| Db indexOf(object:Object):int 
0 呈 isEmpty0:boolean 
mb iterator0:lerator<E> 
Db lastIndexOf(object:Object):int 
mb listfterator0:ListIterator<E> 
加 站 listlterator(location:int):Listlterator<E> 
Db remove(llocation:int):E : 
加 看 removelobject:Objectj:boolean 
Db removeAll(collection:Collection<?>):boolean 
























































[|_| Copy JavaDoc 














生成 add( ) 方法 


插入 动态 模板 


Android Studio 有 很 多 模板 ,允许 您 将 预定 义 的 代码 直接 插入 到 你 的 源 文件 中 。 在 许多 ide, 生 成 
的 代码 只 是 从 模板 中 粘贴 ， 而 从 来 不 考虑 作用 域 : 但 是 Android Studion 的 模板 是 对 作用 域 敏感 
的 ,也 可 以 集成 变量 数据 。 在 你 开始 使 用 Android Studion 的 动态 模板 之 前 ,让 我 们 探索 动态 模板 
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和 和 目 定 义 模板 。 导 航 到 File > Settings > Live Templates 。 通 模 板 组 。 现 在 在 右上 角 
Mote eg 
板 可 以 应 用 之 前 ,您 必须 单 击 Define 按 钮 ,这 看 起 来 像 一 个 蓝 色 的 超 文本 链接 ， 位 于 窗口 的 底 
部 。 现 在 选择 Java 和 选择 所 有 范围 (语句 ,表达 式 , 声 明 等 等 )。 单 击 Apply。 


i 


图 3-18 创建 一 个 名 为 cb 的 动态 模板 (注释 块 ) 


您 刚刚 创建 一 个 称 为 cb 的 自 定义 动态 模板 ,将 在 任何 Java 源 文件 和 任何 沁 围 中 编码 时 都 是 可 
用 的 。 pv 18， 红 色 的 字 $SELECTION$ 是 一 个 变量 。 很 快 你 会 看 到 这 个 变量 在 起 作用 。 动 
态 模 板 的 选项 如 表 3 -4 所 示 


Table $4. Live lemplate Options 
Option PC Keys Mac Keys Description 


Insert Live Template GtriryJ Crmd+J InvoKke a scope-sensitive Live Template list. Will 
iInsert termplate code into your document. 


SurroundwithLive CtrrAltJ -CmdrAltsJ Invoke ascope-sensitve Surround with Live 
Template Template list. WIll surround the selection with a 
scope-sensitive live template. 


在 离开 动态 模板 的 设置 页 面 之 前 ,浏览 一 下 现 有 的 动态 模板 ， 简 称 为 psfs ,在 简单 模板 组 中 。 
单 击 psfs 来 查看 其 内 容 。 你 会 注意 到 这 个 模板 最 终生 成 一 个 公共 静态 的 字符 串 常 量 , 它 仅 在 
Java 和 Groovy 声 明 范 围 可 用 。 单 击 OK 返 回 Editor。 在 sandbox 的 声明 部 分 ,在 mGreetings 的 
定义 下 面 , 键 入 psfs 然后 按 ctrL + ] | cmd + J 调用 动态 模板 ,然后 按 Enter 键 。 给 这 个 第 数 一 


个 多 称 来 完成 这 文 个 声明 并 赋值 ， 如 public static final String HELLO = “Hello Sandbox”; ° 


注意 : 在 Java 中 ,常量 的 命名 约定 是 全 部 大 写 。 在 构造 函数 ,输入 CONSTRUCTORS 这 个 单词 。 现 
在 这 个 词 转换 成 一 个 a ee 厅 员 的 注意 。 选 择 整 个 词 ， CONSTRUCTOR ,然后 

按 ctrl + Alt+J| Cmd+Alt+J 弹出 动态 住 模板 。 从 动态 模板 列表 中 选择 cp 和 

按 Enter 键 ,如 图 3-19。 你 即 可 应 用 在 前 面 创建 的 动态 模板 
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By default expand with | Tab Bd 








bk Ew Groovy 十 
kk Ea htrnl xml 一 
> [¥| iterations : 
F [YI Maven D 
bp [| other 
KF Ew output 
[A ch (comrment block) 
[A psf (public static final) 
[A psfi (publie static final int) 
加 psfs (public static final String) 
加 5 (String) 
名 thr (throw new) 
EF [A surrounmd 
F [中 ZenHTML 加 Everywhere 
> [| Zen XSL * HTML 
> XML 
T [Yl java 
四 起 让 下 丰 Fi 在 站 二 
Abbreviation: Description: [comment block ] ee 
Template text: [A Declaration 
让 Ea Comment 
'/ SSELECTIONS 加 string 
RTT. 加 Smart type completion 
[A Other 
> Groovy 
[LL] Maven 
[Other 


Applicable in Java: Java: statement. expression, declaration, comment, stning, smar...Change 


应 用 动态 模板 称 为 cp (注释 块 ) 


Moving Your Code 


Android Studio 可 以 感知 代码 块 结束 ,所 以 按 行 或 者 代码 块 移 动 都 是 很 容 多 和 直观 的 。 移 动 语 
名 和 移动 行 之 间 的 差别 是 : 移动 语句 代表 着 考虑 界限 和 范围 ,而 行 不 考虑 。 如 果 你 选择 有 着 
Move Statement 的 代码 语 名 来 移动 ， 该 语句 将 保留 它 的 块 的 边界 范围 。 如 果 你 移动 相同 的 有 
着 Move Line 的 语 名 ，Android Studio 将 语句 作为 一 个 简单 的 行文 本 ,并 将 它 移动 到 任何 你 想 要 
到 的 地 方 。 


你 也 可 以 移动 整个 代码 块 。 有 了 Move Statement, 所 有 你 需要 做 的 是 把 光标 放 在 你 想 移 动 的 块 
的 开始 行 ( 花 括 号 的 ), 按 ctrl + Shift + Down | Cmd + Shift +Down 或 
者 ctrl + Shift + Up| Cmd + Shift + Up ， 在 考虑 其 他 的 边界 块 和 保持 封闭 的 边界 范围 内 的 情 
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况 下 ， 整 个 块 将 集体 移动 。Move Line 不 能 识别 范围 或 界限 ,但 你 仍然 可 以 移动 多 行 ， 通 过 


Alt + Shift + Up | Alt + Shift +Down (分 别 在 PC 和 Mac 中 ) 实现 Move Line Up or Move 
Line Down 操作 。 


要 理解 Android Studio 的 移动 操作 ,最 好 就 是 实践 一 下 。 首 先 让 我 们 在 add() 方 法 中 创建 一 个 语 
的， 随后 直接 返回 mGreetings.add(object) , 按 回 车 键 并 开始 一 个 新 行 并 键入 soutm 。 然 后 
按 ctrL +J | cmd + J 贡 用 动 态 模 板 ， 会 产生 System.out.printlin(“Sandbox. add"); ° 您 可 能 
经 注意 到 ,你 的 新 行 代码 将 不 会 达到 ,因为 返回 语句 在 其 上 面 ,如 图 3-20 所 示 。 用 Move 
Statement D0 ， 同 时 按 住 ctrl | cmd 和 shift ,多 次 按 向 上 箭头 键 。Android 
Studio 重新 放置 这 个 语句 ， 但 是 不 让 你 把 这 个 语句 移 到 一 个 可 能 没有 任何 意义 的 范围 。 再 次 
尝试 此 操作 Move Line ( Alt + Shift +Up ), 观 察 其 行为 。 


45; 器 public boolean add(S5tring object) I 

aA6 return mGreetings.add (obJject): 

47 System.out.println("Sandbox.add"):; 
48; 口 ) 

49 

所 站 


Move Statement 和 Move Line 


让 我 们 尝试 一 下 另 一 个 例子 来 演示 移动 Move we 强大 : 把 构造 函数 移动 到 类 的 底 
部 。 确 保 sandbox() 声明 和 上 面 的 注释 块 之 间 没 有 空 。 现在 ,把 你 的 光标 在 声明 

的 sandbox() ， 并 且 按 住 ctrl | cmd 和 shift 键 ， 头 键 来 调用 Move Statement 
Down ， 重 复 直 到 你 的 构造 函数 是 类 的 最 后 一 个 方法 。 注 意 ,整个 块 ,包括 注释 ， 都 移动 到 类 的 


底部 了 ,避免 了 其 他 方法 。 移 动 代码 操作 和 键 训 快 捷 键 表 如 3 - 5 所 示 。 


Jable 5. Move Gode Options 

Option PC Keys Mac Keys Description 

Move Statement Ctrl+Shift+Down Cmd+Shift+Down Noves a statement or statements down, 
Down within the boundaries of scope. If a block 


is moved, the entire block will leapirog en 
masse to the next syntactically correct 


Iocation. 
Move Statement Ctrl+Shift+Up cmd+Shift+Up Same as Move Statement Down, but 
Up moves up. 


Move Line Down Alt+Shift+Down AitrShift+Down Moves statementts) or line(s) down. Does 
not respect scope boundaries or syntax. 
Move Line Up Alt+Shift+Up Alt+Shift+Up Same as Move Line Down, but moves Up. 


样式 代码 


代码 风格 规范 在 不 断 发 展 。 没 有 固定 的 规则 ， 你 应 该 在 你 的 方法 之 后 空格 的 数量 ， 还 是 
左 括 号 应 该 出 现在 同一 行 作为 方法 签名 pda ° 组 织 倾 向 于 定义 和 pr 风格 ,但 每 个 
程序 员 的 代码 风格 也 各 不 相同 ,你 也 可 能 有 你 习惯 的 代码 风格 。 幸 运 的 是 ,Android Studio 很 简 
单 就 能 样式 化 和 组 织 你 的 代码 。 在 开始 样式 化 代码 之 前 ， 让 我 们 检查 一 下 代码 风格 的 设置 。 
选择 File > Settings > Code Style 弹出 设置 对 话 框 ,如 图 3 - 。 Java 和 XML 十 我 们 在 
Android 中 最 感 兴 趣 的 语言 。 在 左 窗 格 中 切换 打开 代码 风格 选项 ,选择 Java, 并 检查 在 设置 窗口 
的 每 个 选项 卡 。 


,Reforma 
i File'Ci\de\andiN\bool\ch03\HelloWorld\app\sr\manyava\com\apress\gerbenN\helloword\app\Sandbox.java' 


All files in directory C\deAandN\boolk\ch03\HelloWorid\app\sr\mainVjava\com\apress\gerber\helloworld\app 
|_ | Qptimize imports 
[YI| Rearrange entries 


Run | Cancel | | Help | 





图 3-21 代码 风格 >Java selected 并 显示 包装 和 括号 选项 卡 的 设置 对 话 框 


通过 在 中 间 的 面板 的 各 种 tab 页 的 这些 设置 选择 /取消 选择 复 选 框 的 实验 ， 注 意 类 在 右 窗 格 中 发 
生 相 应 变化 ,满足 你 的 风格 。 点 击 Manage 按 钮 在 顶部 定义 一 个 新 的 架构 。 现 在 点 击 另存 为 ,给 

您 的 架构 起 一 个 名 字 ， ed 并 单 击 OK。 如 果 你 做 出 进一步 更 改 保存 方案 , 单 击 Apply 按 

钮 应 用 它们 。 当 你 用 ctrL + Alt + L | cmd + Alt+L 格式 化 你 的 代码 ,在 代码 中 设置 你 选择 的 
风格 标签 将 被 应 用 。 代 码 组 织 的 选项 如 表 3 - 6 所 示 。 


Babe +6. Code-Qrganiang Options 

Option PGCKeys MacKeys Description 

Auto-Indent Lines GirirAlt+l GtrlirAalt+l Applies Indenis to the currently selected line or lines 
according to scheme settings. 


Optimilze Imports CtrrAlt+O CtriAltt+O Removes any un-used imports from import statements. 
Androld Studio is so vigilant about Keeping imports 
clean and relevant, that this command is practically 
redundant. 


Rearrange Code None Re-arranges the order of code elements according to 
the rules established in the Arrangement settings. 


Reformat Code CtrlHAlt+L Cmd+Att+L Applies the code style settings for a particular scheme. 


自动 缩 进行 有 助 于 保持 正常 的 行 缩 进 代码 。 在 Java 中 管理 标签 和 缩 进 规则 
过 File > Settings > Code Style > Java > Tabs and Indents 。 自动 缩 进 线 应 用 于 当前 行 ， 或 如 


果 您 有 多 个 行 选中 , 则 是 选中 的 所 有 行 。 


用 
” 3 用 


Sandbox.java ， 选 择 整 个 方法 的 代码 块 , 按 Tab 键 。 块 应 该 向 右 移 动 一 个 选项 卡 的 距离 。 
把 光标 放 在 第 第 ee Ctrl + Alt +I (在 PC 和 和 Mac 中) 8 你 会 注意 到 目 动 缩 进 复 位 这 

线 到 适当 的 缩 进 位 置 ,尽管 方法 块 的 其 余部 ee 。 现在 选择 的 所 有 代码 的 类 

按 ctrl + I| cmd +A ， 并 且 按 ctrl + Alt +I 。 这 次 ,适当 的 缩 进 将 会 应 用 于 整个 文件 。 


重新 整理 代码 


Arrangement 管 理 代 码 中 元 素 的 顺序 。 例 如 ,大 多 数 人 喜欢 保持 在 类 的 顶部 声明 类 成 员 ,其 次 是 

构造 郊 数 , 其 次 是 getter 和 setter 2 和 ?2 3 用 

过 File > Settings > Code Style > Java > Arrangement )»? 您 可 以 编辑 Arrangement 的 安排 设置 
选项 卡 。 在 前 面 的 部 分 中 ,您 将 构造 函数 的 类 。 这 不 是 通常 他 们 在 的 地 方 。 从 主 菜 

code > Rearrange 。 你 会 注意 到 构造 函数 已 经 搬 回 其 预期 的 位 置 一 一 声明 部 分 的 下 面 。 

Rearrange Code 按 照 Arrangement 的 设置 执行 这 种 重 排 操作 。 


代码 重新 格式 化 


重新 格式 化 代码 是 在 代码 样式 化 中 最 强大 的 功能 ， 因 为 它 给 了 你 选择 应 用 的 所 有 代码 风格 选 
项 中 定义 的 代码 风格 设置 。 正 如 您 已 经 看 到 的 ,代码 风格 设置 可 以 通过 从 主 菜单 中 访问 

File > Settings > Code Style 。 此 外 ,重新 格式 化 代码 允许 您 重新 格式 化 当前 选择 的 文 
件 , 或 相同 类 型 的 每 个 文件 和 目录 。 此 外 ,重新 格式 化 代码 允许 您 链接 重新 排列 条 目 ( 这 a 
列 代 码 的 Java 文 件 ), 并 优化 导入 到 命令 ,如 图 3-22。 按 ctrL + ALt+L | cnd + Alt+L ， 尝 试 
重新 格式 化 sandbox.java 。 
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Project Settings [HelloWortd] 
本 Code yle 
General 
Groowy TE PE 
HThL Wrapping ana Braces | Blank Lines | javaDoc | Imperts | Arrangement | Code Generstion | 


i 本 Line breaks 
; torment at first colurnin 
™ Copyright Control statement in one line 
File Colors Muhiple expressions in one line 
File Encodings Simple blocks in one line 
tanit Imple methods mn one line 
Gradle mple classe in one line 
Ensure right margin ls net exceeded 
Braces plcement 
In elass declaration End of lirve 
In method declaratien End of ire 


1 和 交 ] 玫 归 要 了 国生 业 工 炽 总 人 各国] 名人 才 各 当当 站 轨 世 多 
Brivate int £1 = 1 
Brivate StEAing fieldi = "™s 


DDUDDDD 多 mA 


lnspezctiors 
Langusge Injections 
Bien 


public void ool (int 11, int 12, 
) 


Sehermas ard DTOs ‘Cthier End of ine publie tntie wid lorngerierhod|) 
POs Extends/implemenits list Ee wrap tode semetl 


$ling Algn when rultiline J int 
> Tasks Extends/implemenits keyword 1 sO: 
Template Data Languages Throws list 3 nt[] B = Few Lnt [lls a Od 
Align when multiline 癌 int Varl = Ls 
Algn throws to rmethed start nt 本 空中 
[DE Settings Throws keywaord wrap ool (OR00SL, OX, xOess, 
ee Method declaration parameters | 让 这 本 让 
Appearance Algn when rmubtiline 加 | String sl, a2, sa; 
Ee ee pi ter A UD gl = 32 = 33 = "D123456789014 
angobe Foing i 放生 和 | 
» Debugger Method call arguments | int im 
" Edihoe Albgn when multiline 交 
Srv Re Take Priority over eal chain wrapping 
Es New line ter i 
ppearance Place 了 on new line abel: 
T Colors S Fonts 页 Methed parentheses iF tf2 < 3) return: 
Fort Align when multiline | TEL 
General 页 Chained method cals else return: 
Langusge Defaults Alion when multiline 
Console Colors 


Terminal 
Verson Central 


per. gectFool) .foo() .getEar ly 


EY | ence | | apey | [ Hap | 





图 3-2 包含 重新 整理 条 目 选 择 的 重新 格式 化 代码 对 话 框 


环绕 


环绕 ( Ctrl + Alt + T | Cmd + Alt+TI) 是 一 个 在 周围 发 现 功能 的 超 集 ， 环 绕 动 态 模板 
(ctrl +Alt+jJ | cmd+ Alt+J)” 然而 ,环绕 还 包括 选项 来 选择 与 Java 语 名 或 语 名 块 周 
Uo if / else ，try / catch 等 等 。 虽然 在 你 的 sandbox 类 中 ， 简 单 的 代码 不 可 能 产 生 任 何 爱 
控 异 第 , 周 围 的 语 名 可 能 抛 出 天 常 的 try / catch 块 的 周 围 是 最 好 的 应 用 ,这 可 能 是 为 什么 键盘 
快捷 键 ctrL + Alt +T | cmd + Alt + 包括 一 个 T。 环 绕 的 操作 如 表 3 -7 所 示 。 

Table 3=7. suround With Options 

Option PC Keys Mac Keys Description 


SUrround With CtrlirAlt4+T GMmdrAIt+T SUrroundgds the selected statement or 
statements with a Java code block 
such as if/else, for, try/catch, etc. 


Unwrap/Remove Ctri+shift+Delete Cmd+Shift+Delete -Unwraps code blocks from selected 
statement or statements. 


在 sandbox.java 的 add() 方法 中 ， 您 布 望 确保 没有 重复 的 。 让 我 们 用 一 个 if / else 块 围绕 


return mGreetings.add(0bject); 如 图 3-23。 选 择 整 行 , 按 ctrl + Alt +T| cmd+Alt+T 激 
活 周围 。 现 在 从 菜单 中 选择 if / else 。 在 if 的 括号 里 键 


of 


入 !mGreetings. contains(object) ， 在 else 块 返回 lsSer ° 


了 [= Public boolean add(String object) I 


145 Sys3tem.out.println("sandbox.add"):; 
146 if (I'mGreetings.contains(object)) { 
47 return mGreetings.add (object):; 
EE } else I 

49 return false; 

50 } 


图 3-23 用 Surround With 包 装 和 打开 代码 块 


假如 你 的 业务 规则 已 经 改变 ,你 不 再 关心 mereetings 重复 的 条 目 了 。 使 用 Unwrap/Remove 删 
除 刚才 创建 的 if / else 块 。 把 你 的 光标 在 return mGreetings.add(object);， 语 名 的 任何 位 置 ， 
按 ctrl + Shift +Delete| Cmd + Shift +Delete ,并 选择 打开 。 该 方法 现在 看 起 来 应 该 像 之 前 你 
修改 它 的 那样 。 环 绕 的 另 一 个 伟大 的 应 用 是 遍历 集合 。 在 前 面 的 小 节 中 自动 生 

成 tostring() 方法 。 现 在 改变 这 种 方法 遍历 mGreetings 集合 。 删 除 tostring() 方法 的 返回 
语 名 确保 toString() 方法 的 主体 是 空 的 ° 现在 键入 mGreetings ,然后 

按 ctrl + Alt +T| Cmd + Alt+T。 从 列表 中 选择 迭代 lterable, 或 者 按 TI 键 。 再 次 按 

下 Enter 接受 greeting 作为 单个 元 素 的 名 称 。 生 成 的 代码 是 一 个 for - each 和 循环。 注意 到 
Android Studio 明 白 mereetings 包含 字符 串 ,而 且 它 也 产生 一 个 局 部 变量 叫做 greeting 
mGreetings 缺少 m 的 单数 形式 。 进 一 步 修 改 add() 方法 ,如 图 3-24 。 





39 Override 

40:61 口 public String toString() { 

a41: 

42 StringBuilder stringBuilder = new StringBuilder(); 
43: : for (String greeting : mureetings}) 1 

和 stringBuilder.append(greeting + " "); 
45 ] 

46: return stringBuilder.toString() .trim(): 
41 白 } 

削 规 

小 结 


本 草 涵 益 了 Android Studio 最 重要 的 代码 生成 功能 。 我 们 鼓励 您 运 

名 File > Settings > Code Style > Java and File > Settings > Code Style > ， 并 花 几 分 钟 探 
索 各 种 设置 。Android Studio 为 编码 提供 了 很 多 快捷 键 ,但 你 不 必 记 得 。 如 果 你 会 不 知 所 措 ,你 
可 以 使 用 本 书 作为 参考 ,或 者 导航 到 Code 菜 单 和 探索 其 菜单 项 和 子 菜单 作为 参考 。 


勘误 感谢 : Sohnyi ，zhin 
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第 四 章 : 重 构 代 码 


译 者 : qiangxcn 
来 源 : Learn Android Studio 汉化 教程 第 四 草 : Refactoring Code 


在 Android Studio 中 开发 ， 解 决 方案 不 会 总 是 一 路 而 成 的 。 作 为 一 个 有 效 座 的 编程 者 ， 在 你 的 
开发 ， 调 试 和 测试 中 需要 一 些 弹 性 以 及 代码 重 构 。 随 着 在 这 章 中 的 行进 ， 你 将 明白 Android 

Studio 如 何 产生 代码 ; 在 这 章 里 你 将 看 到 Android Studio 如 何 重 构 你 的 代码 。 重 构 代 码 最 大 的 
风险 是 可 能 引入 不 期 望 的 错误 。 通 过 分 析 茶 些 风险 重 构 操作 的 结果 ，Android Studio 减 低 了 这 
些 风险 ， 然 后 激活 Find tool 窗 口 ， 在 发 行 讲 ， 你 可 以 预览 你 的 更 改 -那里 标志 着 任何 错误 或 冲 


在 这 划 里 描述 的 许多 重 构 操作 也 可 不 用 Android Studio 的 重 构 工具 来 执行 。 无 论 怎 样 ， 你 必须 
避免 强行 重 构 (例如: 通过 一 个 全 文 的 查找 /替换 操作 来 重组 代码 ) ， 因 为 在 这 些 情形 下 
Android Studio 不 能 从 引入 的 错误 中 一 直 保 护 你 。 相 反 ， 如 果 Android Studio 发 现 你 企图 一 个 
重 构 操 作 ， 它 将 尽力 避免 你 犯 任何 因 奢 错误 。 例 如 ， 在 Project tool 窗 口中 拖 动 一 个 JAVA 源 文 
件 从 一 1 包 到 另 一 个 包 ， 这 将 强制 产 Refactor > Move 操作 . 由 此 会 分 析 你 的 移动 操作 结果 : 
允许 你 预览 那些 改变 ， 然 后 适当 地 改变 类 中 所 有 的 import 语句 以 适应 合格 的 新 全 包 名 。 


绝 大 多 数 的 重 构 操 作 被 限制 于 一 个 方法 或 一 个 类 里 面 ， 因 而 将 不 太 会 引入 错误 到 你 的 项 目 

中 。 危 险 的 重 构 操 作 是 那些 涉及 到 两 个 或 以 上 的 资源 文件 。 如 果 重 构 操 作 引 入 编译 错误 ， 检 
查 管 理 器 将 在 编辑 器 里 用 红 标 签 标志 那些 被 影响 的 资源 文件 。 基 于 这 点 ， 你 或 者 可 以 企图 去 
修正 它们 ， 或 者 用 ctrl+tz|cmd+z 简单 地 取消 这 个 重 构 操作 了 。 如 果 重 构 操 作 以 没有 编译 错误 
完成 ， 然 而 涉及 到 太 多 资源 文件 , 那 你 还 是 必须 要 测试 及 校 验 你 是 否 引 入 了 任何 实时 错误 。 第 
11 草 涵盖 了 测试 。 


提示 : 你 必须 提交 任何 重要 的 重 构 更 改 ， 作 为 单一 的 Git 提 交 ， 因 此 之 后 你 可 以 轻松 地 回复 那 


个 提交 。 第 7 草 涵盖 了 Git。 


这 划 有 聚焦 于 用 最 好 的 工具 来 执行 重 构 操作 。 在 我 们 探访 独立 的 重 构 操 作 之 前 ， 我 们 乐于 指出 
Android Studio 有 一 个 极其 便利 的 重 构 工具 叫 Refactor >Refactor This .总 在 上 下 文 菜单 中 选 
择 这 个 ， 图 4-1 所 示 ， 集 成 了 绝 大 多 数 有 用 的 重 构 操作 。 快 捷 键 是 CtrltAlt+Shift+T | Ctrl+T ， 
在 PC 上 你 可 以 方便 地 记 首 字母 CAST。 


Das- 











Extract 
Varnable,... 
Constant,.., 
Field... 
Parameter... 
Parameter Object.., 
Nethed... 
Methed Object... 
0, Delegate,., 
Interface,.., 


Superclass... 


WW I I EN ls Ry 


lm 


Find and Replace Code Duplicates... 


Pull Members Up... 

push Members Down,.,, 

Use Interface Where Possible... 

Replace lahertanece vwith Delegatidn,,, 
Replace Constructor with Factory Method... 


| Generify... 





图 4-1 : 重 构 器 Refactor This 菜 单 ， 包 括 了 大 部 分 的 有 用 重 构 操 作 。 


在 你 开始 本 章 的 例子 之 前 ， 修 改 第 3 章 的 sandbox.java 文件 ， 它 没 扩 充 和 包含 任何 方法 或 成 员 
量 ， 象 下 面 的 小 片段 : 


public class Sandbox { 


} 


重 命名 


在 Project 窗口 中 选择 Sandbox 并 导航 到 Refactor> Rename 或 按 Shift+F6 .引出 一 个 对 话 框 
以 允许 你 重 命 名 你 的 类 ， 另 外 也 可 以 重 命名 出 现在 注释 中 ， 测 试 实例 ， 以 及 继承 类 中 的 那些 
名 字 。 重 命 和 Sandbox 为 Playpen 并 点 击 Refactor 按 钮 ， 如 图 4-2 所 示 。 你 将 看 到 在 你 项 目 中 
重 命 名 的 操作 。 现 在 请 用 ctr1l+z | cmd+z 取消 过 文 个 操作 。 





[L_| Search in comments and strings | | Search for let occumences 
Raenarme yarables I Renarme inheriters 


Epo ona || Hep | | 





图 4-2 : 重 命名 Sandox 为 Playpen 


更 改 答 名 的 操作 允许 你 改变 方法 的 下 列 属 性 : 可 视 性 ， 名 称 ， 返 回 类 型 ， 参 数 ， 以 及 例外 抛 
出 。 在 sandbox.java 里 创建 一 个 方法 ， 如 下 面 的 代码 片断 : 


public String greetings(String message)t 
return "Hello ”+ message,; 
} 


将 光标 移 到 单词 greetings 上 面 (高 完 的 粗 体 字 ) 并 按 ctrltF6 |cmd+F6 ， 或 导航 
到 Refactor > Change Signature 。 结 果 对 话 框 会 允许 你 修改 方法 的 签名 ， 如 图 4-3 所 示 。 


Yisilbality: Retumn type Mames 
public 加 string greetings 


parameters Exceptions | 
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图 4-3 : 修改 签名 对 话 框 


在 参数 表 里 ， 点 击 字 符 串 类 型 参数 message 这 项 ， 将 它 的 名 称 从 message 改 为 greet ， 如 图 
4-3 所 示 。 图 标 绿色 的 + 和 红色 的 - 允许 你 分 别 增加 或 减少 方法 的 参数 。 并 且 ， 你 也 可 以 编 
辑 参 数 表 里 面 它 们 的 类 型 和 名 称 。 另 外 ， 修 改 当 前 方法 时 ， 你 可 能 决定 选择 委托 重 载 方法 的 
单 选 按钮 。 选 择 这 个 按钮 将 保留 你 的 原始 万 法 不 受 有 影响， 但 会 生成 另 一 个 你 新 定义 签名 的 方 
法 。 在 JAVA 里 如 果 你 可 能 考虑 一 系列 有 相同 的 名 称 重 载 方法 ， 但 参数 的 顺序 和 /或 参数 的 类 型 
不 同 。 无 论 如 何 ， 你 做 的 更 改 并 没 限制 方法 的 重 载 。 如 果 你 项 望 的 话 通过 点 击 预览 按钮 ， 可 
以 在 提交 它们 之 前 预览 。 按 Refactor 按 钮 完成 并 离开 。 


类 型 移植 


如 标题 所 述 ， 类 型 移植 允许 你 从 一 个 JAVA 类 型 移植 到 另 一 个 。 让 我 们 假设 你 创建 了 一 
个 person 类 。 随 着 你 的 开发 进行 ， 你 发 现 Person 太一 般 了 ， 因 而 你 又 创建 了 一 
个 Manager 类 扩展 于 person 。 如 果 你 想 移植 所 有 的 person 实例 到 Manager ， 你 可 以 用 类 型 


移植 轻松 办 到 。 


将 光标 放 到 greetings 方法 的 String 声明 上 (在 下 面 代码 片段 中 的 高 亮 粗 体 字 ) 并 且 
按 ctrl+Shift+F6 | Cmd+Shift+F6 或 选择 Refactor > Type Migration 。 结 果 对 话 框 如 图 4-4 所 
直 。 


public String greetings(String greet)t{ 
return "Hello ”+ greet,; 
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图 4-4 : 类 型 移植 ， 从 string 到 date 


更 改 java.lang.String 到 java.util.Date ， 如 图 4-4 所 示 。 从 选择 范围 框 的 下 拉 菜 单 里 选择 打 
开 文 件 。 如 同 大 多 数 重 构 操作 ， 通 过 点 击 预 览 按钮 ， 你 可 预览 你 的 更 改 。 这 里 我 们 按 Refactor 
按钮 。 


移动 
你 可 以 通 以 下 三 种 方法 中 的 一 个 方法 来 移动 源 代码 文件 。 
。 在 Project tool 窗 口 拖 动 源 文件 从 一 个 包 到 另 一 个 包 中 : 


e 选择 源 文 件 从 主 菜 单 导 航 到 Refactor > Move ; 
e 在 Project tool 窗 口 选择 源 文 件 并 按 下 F6 。 


右键 点 击 ( 在 Mac 电 脑 上 ctrl -click) com.apress.gerber.helloworld 包 并 选择 New > Package 。 
给 这 个 重 构 目 标 包 命名 。 从 Project tool 窗 口 ， 把 sandbox.Java 拖 放 到 重 构 目标 包 里 ， 当 出 现 
CO 时 按 OK。 在 Project tool 容 口中 执行 的 任何 拖 放 操作 将 自动 产生 一 个 重 构 移 动 操 
作 ， 这 个 会 让 你 安全 地 把 一 个 类 从 一 个 包 移 动 到 别 一 个 包 里 。 
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图 4-5 : 由 于 拖 放 操作 导致 的 重 构 移 动 对 话 框 
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第 四 章 : 重 构 代 码 


除了 移动 类 之 外 ， 你 也 可 以 移动 成 员 变 量 。 在 你 的 sandbox.class 中 ， 定 义 一 个 新 成 员 变 量 如 
下 


public static final String HELLO = "Hello Androld Studio"; 


移动 光标 到 这 行 代 码 上 并 按 下 F6。 导致 一 个 对 话 框 允许 你 移动 成 员 变 量 从 一 个 类 到 为 一 个 。 
如 图 4-6 所 示 。 请 点 击 取 消 按 钮 来 取消 这 次 操作 。 
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图 4-6 : 移动 成 员 变 量 的 对 话 框 


复制 


复制 ， 有 点 象 移动 ， 按 快捷 键 F5 或 选择 主 菜单 里 的 Refactor > Copy 来 访问 。 在 Project tool 
窗口 ， 选 择 之 前 重 构 的 包 中 的 sandbox. java 并 按 下 F5 键 。 在 目标 包 的 拖 放 菜 单 中 选 

择 com.apress.gerber.helloworld 包 并 点 击 OK， 如 图 4-7 所 示 。 彰 我 们 这 里 无 差别 地 复制 JAVA 
源 文件 不 是 一 个 好 主意 ， 因 为 结果 不 明确 且 首 通 存 在 着 错误 。 
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图 4-7 : 复制 类 的 对 话 杠 
全 删除 


64 


让 我 们 来 删除 刚才 复制 的 类 。 在 Android Studio 的 Project tool 窗 口 里 用 Delete 按 键 ,你 总 可 以 删 
除 文件 和 资源 。 在 刚才 重 构 包 中 点 击 Sandbox.java 文件 并 按 下 Delete 键 。 结 果 对 话 框 允许 你 
使 用 安全 删 检查 选项 来 删除 。 安 全 删除 的 先进 之 处 在 于 执行 删除 前 我 们 可 查询 任何 因 依 赖 于 
这 个 资产 而 可 能 导致 的 破坏 ， 如 图 4-8 所 示 。 如 果 在 这 个 项 目 中 发 任何 东西 依赖 于 这 个 资产 ， 
将 给 出 一 个 可 选项 浏览 它们 ， 或 点 击 无 论 如 何 都 删除 可 选项 来 强制 删除 。 
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图 4-8 : 安全 删除 对 话 框 


析出 


析出 不 是 一 个 操作 而 是 几 个 。 这 节 涵 括 了 一 些 重要 的 析出 操作 : 析出 变量 ， 析 出 常量 ， 析 出 
域 ， 析 出 参数 ， 和 析出 方法 。 在 :Sandbox.class: 里 ， 让 我 们 先 移 走 所 有 的 成 员 变 量 和 方法 从 
白 纸 开始 : 


public class Sandbox { 


} 


析出 变量 
用 出 要 量 
在 你 的 sandbox.java 类 里 ， 定 义 一 个 方法 如 下 示 : 


private String saySomething(){ 
return "Something"; 
} 


把 光标 放 到 硬 编码 Something 的 值 〈 粗 体 字 ) 上 并 选择 Refactor > Extract > Variable ， 或 者 
按 ctrl+ALt+V | Cmd+Alt+V 接着 按 回 车 ， 不 要 选择 声明 final 的 复 选 框 。Android Studio 依 据 
硬 编码 字符 囊 析出 一 个 本 地 变量 并 命名 它 。 你 将 以 如 下 代码 告终 : 


private String saySomething(){ 
String something = "Something",，; 
return something; 


析出 第 量 


当 你 开发 Android 的 APP 时 ， 会 发 现 你 会 用 很 多 的 字符 串 作 为 键 -例如 ， 在 Map 和 Bundle 里 。 
因此 ， 析 出 常量 将 会 节省 你 大 量 的 时 间 。 


定义 一 个 方法 象 如 下 的 代码 片段 。 把 光标 放 到 name_key 字符 串 上 并 

按 Ctrl+Alt+C | Cmd+Alt+C 。 结果 对 话 框 将 如 图 4-9 所 示 。 这 里 ，Android Studio 提 供 一 些 建议 
的 名 称 。 按 惯例 ， 常 量 在 JAVA 里 都 应 该 是 大 写 的 。 选 择 NAME_KEY 并 按 回 车 。 注意 : 为 了 创 
建 和 处 理 这 个 方法 而 不 发 生 编译 错误 ， 你 必须 导入 android.os.Bundle 


private void addName(String name, Bundle bundle ){ 
bundle.putString("name_key", name); 


} 


结束 时 你 将 看 一 个 常量 名 称 是 NAME_KEY ， 象 以 下 定义 的 : 
public static final String NAME KEY = "name key"，; 
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图 4-9 : 析出 常量 NAME_KEY 


析出 域 


析出 域 将 转换 一 个 本 地 变量 到 你 的 类 域 (a.k.a. 成 员 变 量 ) 里 。 注意 : 为 了 创建 和 处 理 这 个 方 
法 而 不 发 生 编 译 错误 ， 你 必须 导入 android.os.Bundle 在 你 的 sandbox 类 里 定义 一 个 方法 : 


private Date getDate( ){ 
return new Date( ); 
} 


把 光标 放 到 pate ( 粗 体高 亮 ) 上 并 按键 Ctrl+Alt+F | Cmd+Alt+F 。 你 将 看 到 一 个 对 话 框 如 图 
4-10 所 示 。 在 Android 里 ， 按 惯例 域 (a.k.a. 成 员 变 量 ) 名 的 头 字 母 用 m 。 你 将 会 注意 到 一 个 下 
拉 菜 单 允 许 你 初始 化 当前 方法 中 的 域 ， 域 声明 ， 或 构造 器 。 选 择 域 声明 并 按 回 车 。 
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图 4-10 : 析出 域 对 话 框 
结果 如 下 


private final Date mDate = new Date( ) ; 


private Date getDate( ){ 
return mDate ， 
} 


移 除 final 关键 字 ， 结 果 这 个 域 声明 如 下 : 


private Date mDate = new Date(); 


析出 参数 
析出 参数 允许 你 析出 一 个 变量 并 放 到 封套 的 方法 里 。 在 你 的 sandbox 类 里 定义 一 个 方法 : 


private void setDate(){ 
mDate = new Date( ); 
} 


将 光标 放 到 Date() ( 粗 体高 党 ) 上 ， 按 ctrl+Alt+P | Cmd+Alt+P 接着 按 回 车 。 结 果 这 个 方法 如 
下 代码 片段 所 示 : 


private void setDate(Date date)t{ 
mDate = date., 
下 


析出 方法 


析出 方法 让 你 选择 一 行 或 多 行 行 连续 的 代码 放 到 一 个 分 离 的 方法 中 。 有 两 个 原因 你 会 想 做 这 
个 。 首 先是 方法 太 复 杂 了 。 相 对 于 100 行 的 代码 ， 打 断 它 到 约 10 到 20 行 的 算法 块 会 比较 容易 阅 


读 且 会 较 少 错误 。 


再 者 ， 重 复 的 代码 从 来 就 不 是 好 主意 ， 因 而 如 果 你 发 现 了 重复 的 代码 ， 最 好 析出 它们 成 一 个 
方法 并 在 重复 的 地 方 调用 它 。 通 过 析出 之 前 重复 的 代码 到 一 个 方法 里 并 调用 它 ， 你 可 以 保留 
你 的 方法 在 一 个 地 方 ， 如 果 你 想 修 改 它 ， 你 只 要 修改 一 次 。 在 你 的 sandbox 类 里 重建 下 面 的 
两 个 方法 如 清单 4-1。 你 可 以 自由 地 复制 和 粘贴 。 


清单 4-1 


private String methodHello ()t+ 
String greet = "Hello"; 
StringBuilder stringBuilder = new StringBuilder(); 
for(int nC = 0; nC < 10; nC++)t{ 
stringBuilder.append(greet + nC); 


return stringBuilder.toString( ); 


private String methodGoodbye ()t1 
String greet = "Goodbye",， 
StringBuilder stringBuilder = new StringBuilder(); 
for(int nC = 0; nC < 10; nC++)t 
stringBuilder.append(greet + nC); 


return stringBuilder.toString( ); 


象 我 们 已 经 提 到 过 的 ， 任 何 时 候 你 发 现 重复 一 个 代码 块 或 复制 和 粘贴 代码 块 ， 你 就 必须 考虑 
析出 方法 了 。 选 择 清单 4-1 中 粗 体 高 亮 的 块 。 现 在 按 Ctrl+Alt+M | Cmd+Alt+M 析出 方法 。 将 叶 
现 一 个 对 话 框 列 出 方法 的 签名 。 重 命名 这 个 方法 为 getGreet ， 如 图 4-11 所 示 ， 接 着 点 击 OK。 
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图 4-11 : 析出 方法 对 话 框 


Android Studio 扫 描 你 的 文件 并 看 到 你 有 另外 一 个 确 当 的 代码 块 案例 。 在 处 理 复 制 对 话 框 里 点 
击 Yes 接 受 建议 ， 如 图 4-12 所 示 。 





图 4-12 : 复制 处 理 对 话 杠 


你 将 看 到 清单 4-2 的 代码 。 现 在 结果 方法 很 容易 保留 在 某 个 地 方 。 


清单 4-2. 从 析出 方法 操作 里 得 出 的 结果 代码 


private String methodHello ()t{ 
String greet®= lelj1io, 
return getGreet(greet ) ; 


private String methodGoodbye ()t1 
String greet = "Goodbye",， 
return getGreet(greet); 
private String getGreet (String greet)t{ 
StringBuilder stringBuilder = new StringBuilder(); 
for(int nC = 0; nC < 10; nC++)t 
stringBuilder.append(greet + nC); 
} 


return stringBuilder.toString( ); 


高 级 重 构 


整个 这 章 所 描述 的 剩 下 的 其 他 重 构 操作 是 高 级 别 的 。 如 果 你 有 兴趣 简单 迅速 地 提高 Android 
Studio， 已 经 有 了 足够 的 知识 来 有 效 地 使 用 重 构 操作 ， 也 许 你 可 以 跳 过 这 节 。 但 无 论 如 何 ， 如 
果 你 对 JAVA 有 比较 好 的 理解 并 且 想 钻研 更 多 的 重 构 操作 ， 继 续 看 下 去 吧 。 


移 除 Sandbox.java 里 的 所 有 成 员 变 量 及 方法 ， 从 一 张 白 纸 开 始 。 


public class Sandbox { 


} 


右键 点 击 (Mac 电 脑 用 ctrl + 点 击 ) Project tool 窗 口 里 的 com.apress.gerber.helloworld 包 ， 
选择 New > Java Class 。 命名 这 个 类 为 Minibox 。 修 改 Minibox 类 定义 继承 自 sandbox 并 且 有 
个 成 员 变 量 叫 做 mshovel ， 如 这 里 所 示 : 


public class Minibox extends Sandbox { 
private String mShovel; 


} 


推 高 成 员 变量 以 及 拉 低 成 员 变量 


推 高 成 员 变 量 以 及 拉 低 成 员 变 量 用 于 继承 。 注 意 到 我 们 定义 了 一 个 mshovel 成 员 变量 
在 Minibox 类 里 。 让 我 们 假设 mshovel 可 能 对 于 其 他 继承 自 sandbox 类 的 子 类 也 有 用 。 这 样 
人 做， 打开 Minibox 类 并 选择 Refactor > Pull Members Up 。 结果 对 话 框 如 图 4-13 所 示 。 
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图 4-13 : 推 高 成 员 变 量 对 话 框 
mShove | 会 被 缺少 地 选中 并 且 因 为 Sandbox 且 Minibox 的 父 类 所 以 推 高 成 员 变量 组 合 窗 口 会 
缺 省 地 设 定 在 com.apress.gerber.helloworld.Sandbox 类 上 。 点 击 Refactor， 检 

视 Sandbox 和 Minibox ， 你 将 发 现 mshovel 成 员 变 量 不 再 出 现在 Minibox 里 了 ， 而 属 

于 sandbox 。 作 为 一 般 规 则 ， 如 果 你 觉得 一 个 成 员 变 量 对 其 他 扩展 类 也 是 有 用 的 ， 那 么 就 把 
这 些 成 员 变 量 在 继承 层次 里 推 遍 。 用 类 似 的 手法 可 以 拉 低 成 员 变 量 。 


解除 继承 并 委托 成 员 变 量 


右键 点 击 (Mac 电脑 用 Ctrl + 点 击 ) com.apress.gerber.helloword 包 选 
择 New > Java Class 。 命 名 这 个 新 类 为 patio 并 继承 自 sandbox 


public class Patio extends Sandbox { 


} 


进一步 分 析 后 ， 我 们 决定 patio 不 是 一 个 sandbox ， 但 更 象 是 它 拥有 一 个 sandbox 。 为 了 改 
变 它 们 的 关系 ， 导 航 到 Refactor > Replace Inheritance with Delegation 。 在 结果 对 话 框 里 ， 
点 击 为 委托 成 产生 getter 方法 ， 如 图 4-14 所 示 。 


下 | Repla de Irihe Fetarice WN 


Beplace with delegation mheritance frorm: 
ey 自 com-apressJerber-helloworld-Sandbox 





Dalegate rverbers 
| 


ahem be oho 


Ea Generste getter for delegated component 


et. actior 





图 4-14 : 解除 继承 并 委托 成 员 变 量 对 话 框 


现在 你 的 patio 类 将 拥有 一 个 Sandbox 成 员 变 量 ， 如 下 代码 片段 所 示 : 


public class Patio { 
private final Sandbox mSandbox = new Sandbox( ); 
public Sandbox getSandbox() { 
return mSandbox; 
} 


封装 域 


封装 域 是 一 种 面向 对 象 策 略 ， 通 过 使 访问 级 别 为 私有 来 隐藏 类 成 员 变量 并 提供 以 公开 

的 getter/setter 方法 作为 公开 的 接口 。 尽管 当 你 选择 Refactor > Encapsulate Fields 时 有 很 
多 的 选择 ， 但 Refactor > Encapsulate Fields 类 似 于 code > Generate > Getter and Setter 。 
打开 你 的 Sandbox 类 并 定义 一 个 成 员 变 量 叫 mchildren ， 如 下 面 代码 片段 中 的 粗 体 高 亮 部 


分 。 从 主 菜 单 ， 选择 Refactor > Encapsulate Fields ° 


public class Sandbox { 
private String mShovel; 
private int mChildren, 


结果 对 话 框 允许 你 精确 地 选择 怎样 封装 这 些 域 以 及 它们 的 访问 级 别 。 由 正 地 封装 域 将 有 一 个 
私有 的 可 视 度 及 公有 的 访问 ( getter ) 及 改变 ( setter ) 方法 。 点 击 Refactor 按 钮 ， 如 图 4- 
15 所 示 ， 注 意 到 Android Studio 在 我 们 的 sandbox.java 类 里 为 我 们 生成 所 有 


的 ] getter 和 setter 。 


第 四 章 : 重 构 代码 
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图 4-15 : 封装 域 对 话 框 


包装 方法 的 返回 值 类 型 


| ， 和 包装 返 回 值 可 能 是 有 用 的 (当然 还 有 其 他 的 
情形 你 可 外 能 想 包 个 返回 值 ) 。 把 光标 放 到 getchildren() 方法 上 并 导航 
到 Refactor > Wrap Method Return value 。 选择 Use Existing Class 选 项 ， 名 称 框 输 


入 java.lang.Integer ， 包 装 域 框 则 选择 value， 如 图 4-16 所 示 。 现 在 点 击 Refactor 按 钮 且 注 意 


到 你 的 getchildren() a Integer 类 ， 而 不 是 基本 数据 类 型 int 。 
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图 4-16 : 包装 返回 值 对 话 框 
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第 四 章 : 重 构 代 码 


用 工厂 方法 代替 构造 器 


把 光标 放 在 Sandbox 类 定义 附 栏 内 o 按 ALt+Insert | Cmd+N 接着 选择 生成 一 个 新 构造 器 ° 选 
择 所 有 成 员 变 量 ， 如 图 4-17 所 示 ， 然 后 点 击 OK。 


加 
T I comapres.gerberhdloword.Sandbox 
四 meahovel Stnno 


机 不 | 1 本 re et 








图 4-17 : 通过 构造 器 来 选择 域 的 对 话 杠 


将 光标 放 到 如 下 所 示 代 码 片 段 构造 器 的 任何 位 置 ， 并 导航 
到 Refactor > Replace Constructor with Factory Method 。 结果 对 话 框 詹 图 4-18 所 示 。 点 击 
Refactor 来 生成 一 个 工厂 方法 。 


public Sandbox(String shovel, int children) { 
mShove = shovel; 
mChildren = children,; 


Factory method name: 


In (fulty qualified namae): 





























图 4-18 : 用 工厂 模式 代替 构造 器 的 对 话 框 


注意 到 之 前 的 构造 器 现在 变 成 private 了 并 且 一 个 新 的 静态 方法 返回 sandbox 类 的 实例 ， 如 
下 面 代 码 片 段 所 示 。 如 果 你 正 创建 一 个 单 例 类 ， 这 将 会 是 非常 有 用 的 。 


public static Sandbox createSandbox(String shovel, int children) { 
return new Sandbox(shovel, children); 
} 


续 换 匿名 内 部 类 


/3 


在 你 的 Sandbox 类 的 构造 器 里 加 上 下 面 行 


new Thread(new Runnable()).start(); 


i 


实现 方法 。 


条 
bl 


把 光标 放 在 Runnable() 上 并 按 下 Alt+Enter 来 调用 完成 代码 操作 。 然 后 选 了 
择 run() 方法 并 点 击 OK。 你 的 代码 将 到 下 面 亡 段 所 示 : 


new Thread(new Runnable() { 
QOverride 
public void run() { 
//do something 


} 
}).start(); 


把 光标 放 在 Runnable() 上 并 导航 到 Refactor > Convert Anonymous to Inner 。Android Studio 
建议 MyRunnable 作为 这 个 类 名 ， 如 图 4-19 所 示 。 去 选 Make class static 选 点 击 OK。 注意 
到 你 将 在 sandbox 类 里 得 到 一 个 私有 的 内 部 类 叫 MyRunnable ， 它 实现 Runnable 。 这 个 例 
子 没 有 做 更 多 的 事 ; 不 管 怎样 ， 当 委派 view 的 行为 时 你 也 许 有 机 会 用 到 这 个 。 


[|_| Make class static 


Corstruer Parareters 


Type 





图 4-19 : 转换 匿名 内 部 类 的 对 话 框 


这 草 讨 论 了 Android Studio 目 前 有 效 的 许多 重 构 操 作 。 重 构 代 码 是 编程 工程 的 一 个 必需 的 部 
分 ，Android Studio 里 的 重 构 工具 是 取 好 的 重 构 工具 之 一 。Android Studio 通 过 分 析 推 理 以 及 
允许 你 于 提交 操作 前 在 Find tool 窗 口 预 览 结 果 ， 减 低 了 某 些 操作 执行 的 风险 。 最 重要 的 是 重 构 
操作 Refactor > Refactor This 对 话 框 是 如 此 有 效 的 ， 这 个 可 以 通过 用 快捷 

键 Ctrl+Alt+Shift+T | Ctrl+T 来 调用 。 


第 五 章 : Reminders 实 验 : 第 一 部 分 


译 者 : qiangxcn 


大 大 


e。 Learn Android Studio 汉化 教程 第 五 章 : Reminders 实 验 : 第 一 部 分 
e Learn Android Studio 汉化 教程 第 五 章 : Reminders 实 验 : 第 一 部 分 ( 续 ) 


到 现在 为 止 你 已 经 熟悉 了 创建 一 个 新 项 目 ， 编 程 ， 和 重 构 的 基本 操作 了 。 是 时 候 创 建 一 个 
Android 应 用 了 ， 或 者 说 成 我 们 所 谓 的 APP。 这 章 将 介绍 四 个 实例 项 目的 第 一 个 。 这 些 实例 目 
的 是 让 你 熟悉 使 用 Android Studio 开 发 APP 的 上 下 文 方面 。 核 心 功能 是 允许 你 创建 和 删除 一 个 
提醒 以 及 标志 那些 重要 的 提醒 。 重 要 的 条 目 文体 左边 将 被 强调 黄色 标签 。 这 个 APP 将 合同 一 
个 动作 条 菜单 ， 上 下 文 菜单 ， 一 个 本 地 的 数据 库 作 存储 ， 如 果 设 备 支持 的 话 还 有 多 重 选 择 。 


图 5-1 图 示 了 仿 卜 器 上 完成 的 app。 这 个 例子 介绍 了 Android 基 础 并 且 你 也 会 学 到 如 何 用 内 建 的 
SQLite 数 据 库 来 保存 数据 。 别 担心 那些 你 不 熟悉 的 话题 ， 后 续 的 草 节 将 涵 括 这 些 话题 大 量 的 
细节 。 


注意 : 为 了 一 致 性 ， 我 们 建议 你 用 Git 元 隆 这 个 项 目 ， 虽 然 你 将 从 草稿 里 用 它 自身 的 Git 行 储 库 
重建 这 个 项 目 。 如 果 你 还 没有 安装 Git， 请 看 第 7 章 。 在 窗口 里 打开 一 个 Git-bash 会 话 (在 Mac 
或 Linux 里 的 终端 ) 并 导航 到 Cc:\androidBook\reference、( 译 者 注 : 在 Git-bash 控 制 台 里 可 以 
使 用 Dos 命 令 cd c: 改 当 前 盘 为 c; dir 查看 当前 目录 文件 : cd androidBook 进 

入 androidBook 子 目录 ; cd reference 进入 reference 子 目录 ) 《如果 没 有 这 个 目 录 创 建 
它 ) 并 提交 下 面 的 Git 命 

St git clone https://bitbucket.org/csgerber/reminders.git Reminders ° 
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图 5-1 完成 的 app 漠 面 





操作 Reminders 这 个 app， 你 可 以 用 动作 条 的 溢出 菜单 。 点 击 溢出 按钮 ， 在 菜单 栏 右 侧 ， 看 起 
来 象 重 直 点 ， 打 开 一 个 菜单 如 图 5-2 有 两 个 选项 : 新 提醒 ， 和 退出 。 点 击 新 提醒 打开 一 个 对 话 
框 如 图 5-3。 在 这 个 对 话 杠 里， 你 可 以 为 新 提醒 加 入 文本 并 且 点 提交 加 到 清单 里 。 点 击 退 出 。 
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图 5-2 激活 溢出 菜单 的 app 界 面 
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图 5-3 新 提醒 对 话 框 


点 击 清单 中 的 随意 一 个 提醒 有 两 个 可 选 方式 ， 如 图 5-4 : 编辑 提醒 和 删除 提醒 。 从 上 下 文 菜单 
中 点 编辑 提醒 ， 弹 出 对 话 框 如 图 5-5 所 示 ， 在 那里 你 可 以 修改 提醒 里 的 文本 。 点 击 删 除 提 醒 则 


会 删 掉 这 个 提醒 。 
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图 5-4 上 下 文 茶 单 
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图 5-5 编辑 提醒 对 话 框 


开始 一 个 新 项 目 


在 Android Studio 开 始 一 个 新 的 项 目 ， 用 新 项 目 向 导 如 同 在 第 1 章 里 所 介绍 的 。 输 入 
Reminders 作 为 项 目 名 ， 设 置 公司 域名 为 gerber.apress.com ， 并 选 Blank Activity 模板 。 保 
存 到 c:\androidBook\Reminders 。 为 了 我 们 例子 的 一 致 性 ， 这 是 一 个 好 主意 保存 你 所 有 的 实验 
项 目 到 同一 个 目录 ， 比 如 c:\androidBook (Or use ~/androidBook 对 于 Mac/Linux 来 说 )。 在 
向 导 的 下 一 页 ， 选 择 电话 和 等 上 设备 并 设置 最 低 支持 SDK 到 API 8:Android 2.2( 冻 酸奶 )。 通 过 
设 定 最 低 支 持 SDK 到 APIl8， 你 让 这 个 app 支 持 目前 市 场 上 99% 的 设备 。 点 击 下 一 步 按钮 ， 选 
择 Blank Activity ) 再 点 下 一 步 ° 设置 activity 名 称 为 RemindersActivity 并 点 完成 ， 如 图 
5-6 所 示 。 


Choose options for your new file 
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图 5-6 输入 activity 名 称 


Android Studio 在 设计 模式 下 显示 activity_reminder.xml 。 这 是 你 的 主 activity 的 布局 ， 如 


图 5-7 示 。 如 同 第 1 章 所 讨论 的 ， 在 这 刻 项 目 可 以 运行 在 仿真 器 上 或 设备 上 。 只 要 你 乐意 随便 
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图 5-7 activity_reminders 的 设计 模式 


第 五 草 : Reminders 实 验 : 第 一 部 分 


初始 化 Git 行 储 库 


建立 新 项 目 后 的 第 一 步 必 须 是 用 版 本 控制 来 管理 源 代码 。 所 有 这 本 书 的 例子 都 用 Git， 一 个 流 
行 的 版 本 控制 系统 ， 无 颖 地 协同 Android Studio 工 作 并 且 一 直 是 在 线 免费 的 。 第 7 章 更 彻底 地 
探索 了 Git 和 版 本 控制 。 


如 果 你 还 没 安 装 Git， 请 参考 第 7 草 。 从 主 菜单 选 
择 vcs>Import into Version Control>Create Git Repository 。 (在 IOS 上 ， 选 
时 


个 流 和 


O 〇 


择 vcs >vcs operations>Create Git Repository ) 图 5-8 和 5-9 展 示 了 这 


ee 
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图 5-8 创建 一 个 Git 存 储 库 


82 








两 Select directory for git init 


Select directory where the new Grt repository will be created. 
全 融 号 其 的 部 Hide path 
| | CN\androidBook\Reminders 
vv DReminders 
四 .grsdle 
品 .idea 
DD app 
四 build 
加 libs 
品 sre 
DD androidTest 
main 
- 口 java 
回 res 
: 品 drawable 
DD drawable-hdpi 
四 drawable-mdpi 
四 drawable-xhdpi 


四 drawable-whdpi 
| = 


Cancel | | Help | 


图 5-9 为 Git 存 储 库 选 择 根 目录 





当 提 示 选 择 Git 的 初始 目录 ， 确 认 初 始 化 为 项 目的 根 目 录 (再 次 ， 在 这 个 例子 里 是 
Reminders) 。 点 击 OK。 


你 将 注意 到 项 目 工具 窗 里 大 部 分 文件 变 成 棕色 的 ， 意 味 着 它们 被 Git 跟 踪 但 还 没 加 入 到 Git 的 存 
储 库 而 且 时 刻 表 也 没 加 载 。 一 但 你 的 项 目 被 Gitr 控 制 ，Android Studio 使 用 一 个 色彩 策略 ， 随 
着 我 们 项 目的 进行 将 会 解释 更 多 的 细节 。 当 然 你 也 可 能 在 这 : jetbrains.com/idea/help/file- 
status-highlights.html 得 更 多 的 细节 ， 如 果 你 想 研 究 的 话 。 


点 击 位 于 窗口 底部 边缘 的 Changes 工 具 按 钮 切换 打开 Changes 工 具 窗 口 并 展开 叶子 标签 的 未 
受 版 本 控制 文件 。 这 将 显示 所 有 被 跟踪 的 文件 。 为 加 载 它们 ， 选 择 未 受 版 本 控制 文件 叶子 并 
按 Ctrl+Alt+A | Cmd+Alt+A 或 右 击 未 受 版 本 控制 文件 叶子 并 选择 Git>Add 。 棕 色 文 件 将 会 变 成 
绿色 ， 意 味 着 它们 在 Git 中 已 阶段 化 而 且 现 在 准备 被 提交 了 。 


按 ctrl+k | cmd+K 来 调用 提交 更 改 对 话 框 。 提 交 文 件 是 Git 版 本 控制 系统 记录 项 目 更 改 的 一 个 
过 程 。 如 图 5-10 所 示 ， 授 权 者 下 拉 菜 单 用 于 重 写 当前 缺 省 提交 者 。 让 这 栏 空 着 吧 ， 这 样 
Android Studio 将 简单 地 用 你 安装 Git 时 设 的 缺 省 值 。 去 选 Before Commit 多 选 框 里 所 有 的 选 

项 。 把 下 面 的 信息 放 入 到 Commit Message 区 里 : Initial commit using new project wizard。 点 
击 提 交 按 钮 并 在 下 拉 条 目 里 再 次 选择 提交 。 
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图 5-10 提交 更 改 到 Git 


默认 情况 下 ， 项 目 工 具 窗 将 会 打开 。 项 目 工 具 窗 以 不 同 的 方式 组 织 你 的 项 目 ， 取 决 于 顶部 窗 
口 的 下 拉 菜 单 所 选择 的 示 图 。 缺 省 地 ， 下 拉 菜 单 是 Android 示 图 ， 它 按 文件 目的 组 织 文件 而 不 
是 按 你 电脑 操作 系统 组 织 文件 的 方式 。 当 你 展开 项 目 工具 究 ， 将 注意 到 三 个 文件 夹 在 app 文 件 
夹 下 : manifests, java, 和 res。Manifests 文 件 夹 里 有 你 的 Android manifest 文 件 。Java 文 件 夹 
是 存放 java 源 文件 的 地 方 。Res 文 件 夹 保存 所 有 你 的 Android 资 源 文件 。 在 res 目 录 下 的 资源 可 
能 是 XML 文件 ， 图 象 ， 声 音 ， 和 其 他 资源 用 于 帮助 定义 你 的 app 外 观 和 用 户 体 验 。 一 但 你 有 机 
会 展开 Android 示 图 ， 我 们 推荐 切换 到 Project 示 图 ， 它 更 直观 因为 它 直 接 反映 了 你 电脑 上 的 目 
录 结 构 。 


构建 用 户 毁 


默认 情况 下 ，Android Studio 打 开 与 主 activity 相关 联 的 XML 布局 文件 在 一 个 新 的 编辑 选项 
卡 里 并 设置 为 设计 模式 ， 因 而 通 第 你 在 新 项 目 里 先 看 到 的 是 可 视 化 开发 颈 。 可 视 化 开发 器 证 
你 编辑 app 的 可 视 化 布局 。 a 中 央 是 预览 面板 。 预 览 面板 是 Android 设 备 泻 染 你 当前 编 
辑 的 布局 结果 的 应 拟 展示 。 这 个 展示 可 控 于 屏幕 上 方 横 足 的 布局 预览 控制 。 这 些 控制 可 调整 


预览 并 选择 不 同 风 格 的 Android 设 备 ， 从 智能 电话 到 穿戴 设备 。 你 也 可 以 改变 布局 里 所 描述 的 
相关 主题 。 屏 幕 的 左边 ， 你 会 发 现 控件 板 。 包 含 了 众多 的 控件 和 widget ， 它 们 可 被 拖 放 到 正 
虚拟 展示 的 设备 平台 上 。|IDE 的 右 侧 包 含 了 一 个 组 件 树 展示 了 布局 里 组 件 的 层次 关系 。 布 局 使 
用 XML 文件 。 当 你 在 这 个 可 视 化 开发 器 作出 修改 时 ， 这 些 修改 将 更 新 于 XML 中 。 你 可 选择 
Design 或 Text 选 项 卡 来 切换 可 视 化 或 是 文本 编辑 模式 。 图 5-11 标 识 几 个 可 视 化 开发 颖 关键 区 
域 。 
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图 5-11 可 视 化 开发 绒 价 


工作 于 图 形 化 编辑 器 


让 我 们 开始 创建 reminders 的 列表 项 吧 。 在 平台 上 点 击 Hello World 文本 框 并 删除 它 。 找 

到 ListView 控件 并 拖 放 到 平台 里 。 当 你 拖 动 时 ，IDE 将 显示 变化 着 的 尺寸 度量 以 及 排列 参考 
来 帮助 你 定 们 控件 ， 那 些 当 你 拖 动 靠近 它们 时 会 企图 抓 住 边缘 。 拖 放 listview 它 会 在 屏幕 顶 
部 排列 。 你 可 以 定位 在 顶部 的 左边 或 中 间 。 在 定位 后 ， 找 到 在 编辑 器 右 下 侧 的 属性 示 图 。 设 
置 id 属性 为 reminders list view 。 Id 属性 是 你 可 以 在 JAVA 代码 里 控件 编程 参考 ; 且 这 

是 我 们 将 如 何 参考 的 ListView 在 之 后 修改 代码 时 。 修 改 layout:width 属性 设置 

为 match _parent 。 这 将 扩展 控 件 动态 地 占有 尽 可 能 多 的 父 、 控 件 宽 度 °。 关于 布局 在 第 $8 草 里 你 会 
学 到 更 多 细节 。 现 在 ， 你 的 布局 将 装配 成 图 5-12 那 样 。 


图 5-12 有 个 Listview 的 activity_reminders 的 布局 


ww) 
A 


在 Android 里 ， 一 个 activity 定义 了 控制 用 户 和 app 交 互 的 逻辑 。 当 第 一 次 学 Android 时 ， 
把 activity 想象 成 你 的 app 的 一 个 屏幕 是 对 你 有 帮助 的 ， 虽 然 activity 要 比 这 个 复杂 得 多 。 
布局 文件 定义 为 一 个 XML， 但 用 旱 先 提 到 的 图 形 化 编辑 器 可 以 图 形 化 编辑 。 


编辑 布局 的 原生 XML 


点 击 编辑 器 左下 方 的 文本 选项 卡 ， 从 图 形 化 编辑 切换 到 文本 编辑 模式 。 这 带 来 了 布局 的 原生 

XML 示 图 ， 右 边 伴随 着 一 个 预览 面板 。 将 RelativeLayout 的 背景 色 改 为 黑色 ， 插 入 这 

行 : android:background="#181818" 到 android:layout_height="match_parent" 下 面 。 磊 色 用 十 
六 进 制 来 表达 。 可 以 看 下 第 9 章 关 于 十 六 进 制 颜色 的 更 多 信息 。 注 意 到 你 插入 那 条 设置 根 示 图 
背 录 色 那 行 后 夹缝 里 的 黑 灰 色 的 样本 。 如 果 你 回 到 设计 模式 ， 会 观察 到 整个 布局 变 成 黑 灰色 


O 〇 


| 


st 色 值 到 你 的 XML 文 件 里 不 是 最 好 的 途径 。 更 好 的 选择 是 定义 一 
个 colors.xml 文件 到 资源 文件 夹 里 ， 并 在 那 定义 你 的 闫 色 。 在 XML 文 件 (如 colors.xml ) 里 
实现 值 的 原因 是 那些 资源 被 保存 和 编辑 在 一 个 地 方 并 且 在 在 整个 项 目 里 可 以 轻松 地 参考 。 


用 ctrl+Xx | Cmd+X 或 通过 主 菜单 的 Edit > cut 选择 十 六 进 制 的 闫 色 值 #181818 并 剪 切 它 到 
粘贴 板 。 输 入 @color/dark_grey 到 这 个 位 置 。 这 是 一 个 特殊 的 语法 参考 到 Android 资 源 文 

件 colors.xml ， 但 这 个 文件 还 不 疮 在 于 你 的 项 目 里 ，Android Studio 会 高 完 红 色 指 出 这 个 错 
误 。 按 Alt+Enter 会 提示 纠正 这 个 错误 的 选项 。 选 择 第 二 个 选项 ， 创 建 闫 色 资 源 dark_grey ， 
接着 把 刚才 的 磊 色 值 粘贴 到 资源 值 里 : 下 个 出 现 的 对 话 框 值 域 并 点 击 OK。 


新 磊 色 值 资 源 对 话 框 将 创 nn 资源 文件 colors.xml hae ee 。 点击 OK 接着 
在 加 入 文件 到 Git 对 话 框 里 还 是 点 Os ， 这 个 新 文件 加 入 到 版 本 控制 ， 并 确保 选 
RememberDon't Ask Again 这 个 复 选 框 因 而 这 个 信息 下 次 不 Mee 了 。 和 5-13 演 示 了 这 


个 流程 © 


图 5-13 析出 硬 代码 磊 色 值 到 一 个 资源 文件 


在 预览 模式 下 这 个 Listview 控件 包含 的 行 布局 在 我 们 所 选 的 背景 色 时 没有 足够 的 对 比 度 。 要 
改变 这 项 表 崩 ， pe 右 击 资源 文件 夹 里 的 布局 文件 夹 并 
选择 New > Layout Resource File 。 在 新 资源 文件 对 话 框 里 输入 reminders_row 。 在 根 示 图 组 
里 用 线性 布局 并 让 其 他 的 为 默认 值 ， 如 图 5-14 所 示 。 


图 5-14 新 资源 文件 对 话 框 


We 最 外 层 的 元 素 。 在 预览 面 
板 顶 部 的 工具 栏 控制 钮 设置 其 走向 为 重 直 方向 。 当 你 用 这 个 控制 钮 时 小 心 点 ， 因 为 水 平 线条 
表示 的 是 重 直 方向 ， 反 之 亦 然 。 图 5-15 高 完了 这 on 


图 5-15 修改 走向 按钮 


在 预览 面板 的 右 下 方 找到 属性 示 图 。 找 到 layout:height 属性 并 设 为 56dp 。 这 个 控制 控件 的 
高 度 ， dp 2 度量 系统 。 这 是 公开 的 ，Android 允 许 布局 参照 屏幕 重 
绘 时 的 密度 合适 地 缩放 。 你 可 以 点 击 这 个 示 图 里 的 任意 属性 并 增 量 键入 搜索 属性 ， 并 按 上 下 
键 继续 搜索 。 


放 一 个 水 平 线性 布局 到 重 和 直线 性 布局 里 。 拖 放 一 个 自 定 义 控 件 到 水 平 线性 控件 里 并 设置 它 的 
类 属性 为 android.view.View ， 来 创建 一 个 通用 的 空 示 图 并 付 耶 id 为 row_tab 。 在 写 这 篇 文 
章 时 ，Android Studio 还 是 有 点 局 限 : 它 不 允许 你 从 控件 板 里 拖 放 通用 示 图 。 当 你 点 

击 CustomView 时 ， 将 得 到 一 个 有 不 同 选项 的 对 话 框 ， 没 有 一 个 包括 了 通用 的 view 类 。 选 择 
任意 一 个 类 并 放 到 你 的 布局 里 。 为 这 个 限制 的 情况 找到 类 属性 并 修改 为 android.view.View 。 
对 照 清单 5-1 看 看 如 何 完 成 它 


你 将 会 用 到 这 个 通用 的 view 选项 卡 来 标记 那些 提醒 条 是 很 重要 的 。 还 在 文本 编辑 模式 时 ， 修 
改 你 的 用 户 目 定 义 示 图 的 Jayout :width 属性 为 me ” layout:height 属性 为 match _paren t。 
这 里 用 的 match _parent 值 将 让 这 个 示 图 控 件 旭 它 1 全 样 高 。 切换 到 设计 模 式 并 拖 放 一 
个 大 文本 控 件 到 水 平 线 ， 性 布 局 的 元 件 树 上 ， a 高 属性 为 match_parent °。 检 查 下 这 2 
文本 元 件 定 位 于 用 户 自 定义 示 图 控件 的 右 侧 。 在 元 件 树 里 ， 标 志文 本 视图 的 元 件 一 定 是 诅 套 
在 水 平 线性 布局 元 件 里 面 并 且 在 示 图 元 件 下 面 。 如 果 文 本 视图 在 示 图 元 件 上 面 ， 把 它 拖 下 来 
放 到 第 二 TR 的 位 置 。 给 这 个 文本 视图 一 个 id 值 [ow_text 并 设置 文字 尺寸 

为 18sp 。 sp 这 个 单位 参照 像素 独立 密度 度量 系统 ， 但 dp 那样 ， 但 它 间 上 照 用 户 的 文本 尺寸 
设置 ， 因 而 比如 : 如 果 用 户 很 难看 清 并 想 他 的 手机 上 的 显示 更 大 的 文字 ， sp 将 章 照 这 个 设 
置 ， 然 而 dp 不 会 。 因 此 ， 用 sp 作为 文字 的 尺寸 单位 总 是 一 个 好 点 子 。 你 将 在 第 8 章 学 到 有 
关 屏 幕 度量 的 更 乡 内 容 。 


最 后 ， 设 置 文本 控件 的 文本 属性 为 "Reminder Text" 。 切 换 到 文本 编辑 模式 做 更 多 的 修改 如 清 
单 5-1 所 示 。 


清单 5-1 reminders_row 布局 XML 代码 


<?Xm]L version="1.0" encodling= utf-8 ?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match_parent" 
android:layout_height="50dp" 
android:orientation="vertical"> 
<LinearLayout 
android:orientation="horizontal" 
android:layout width="match_parent" 
android:layout_ height="48dp"> 
<vliew 
android:layout _ width="1i0dp" 
android:layout_ height="match_ parent" 
class="android.view.View" 
android:id="@+id/row_ tab” /> 
<TextView 
android:layout width="match_parent" 
android:layout_ height="50dp" 
android:textAppearance="? 
android:attr/textAppearanceLarge" 
android:text="Reminder Text-… 
android:1id="@+id/row_text" 
android:textSize="18sp" /> 
</LinearLayout> 
</LinearLayout> 


现在 要 创建 一 些 用 户 磊 色 了 。 切 换 到 设计 模式 。 选 择 元 件 树 线性 布局 ( 生 直 方向 的 ) 的 根 。 
设置 android:background 属性 为 @color/dark_grey 来 重用 之 前 所 定义 的 闫 色 。 在 元 件 树 里 选 
择 row_tab 元 件 并 设置 它 的 android:background 属性 为 A ° 选择 row_text 元 件 并 
及 置 它 的 android:textColor 属性 为 @color/white ° 在 这 之 前 前 ? 这 些 顾 色 并 没 设 置 

在 colors.xml 里 ， 彰 之 前 那样 定义 它们 。 切 换 到 到 文本 模式 。 按 F2 在 这 两 个 错误 问 重复 地 跳 
前 和 跳 后 并 按 Alt_Enter 带 出 智能 建议 。 选 择 第 二 个 建议 并 在 弹出 对 话 框 里 

用 #ffffff 和 #603306 修正 白色 和 绿色 的 问题 。 修 正 这 些 问 题 后 ， 你 可 以 按 ctrl 键 和 左 键 点 
击 这 些 颜 色 将 带 到 colors.xml 文件 里 ， 如 清单 5-2 代 码 所 示 。 


Listing 5-2. The colors.xml File 


<resources> 
<color name="dark_grey">#181818</color> 
<color name="white">#ffffff</color> 
<color name="green">#003300</color> 
</resources> 


回 到 activity_reminders.xml 布局 文件 。 现 连结 新 的 reminders_row 布局 到 这 个 布局 了 。 切 换 
到 文本 模式 并 加 入 现 面 的 属性 到 Listview 元 素 里 tools:listitem="@layout/reminders_row" ， 
如 图 5-16 所 示 。 


加 上 这 个 属性 在 运行 时 并 没 改 变 布 局 的 表象 ; 它 只 不 过 改变 这 个 list view 的 每 个 条 目的 预 
览 面 板 。 要 让 这 个 新 布局 有 用 ， 你 必须 用 JAVA 代码 充实 它 ， 这 个 我 们 将 在 后 续 的 章节 里 展示 


合 你 。 
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只 
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图 5-16 预览 面板 现 正 展示 一 个 用 户 自 定义 的 Listview 布局 
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I Tt | 证 给 


加 入 图 形 增 强 


刚刚 完成 一 个 Listview 条 目的 用 户 自 定义 布局 ， 但 你 不 会 停止 在 这 里 。 加 入 一 些 视觉 增强 元 
素 将 让 你 的 app 与 众 不 同 。 下 文本 如 何 显示 在 屏幕 上 上。 精明 点 ee | 它 有 点 点 偏离 


中 心 并 跑 出 绿色 选项 卡 的 左 了 reminder_row 布局 做 点 小 调整 。 望 文本 重心 朝 行 内 
重 直 方向 的 中 心 去 点 ， 并 a 这 样 和 边界 就 有 点 视觉 上 的 分 离 。 单 5-3 的 代码 代替 


你 的 TextView 元 素 9 


Listing 5-3. TextView Additional Attributes 


<TextView 

android:layout width="match_parent" 
android:layout_ height="50dp" 
android:text="Reminder Text" 
android:id="@+id/row_ text" 
android:textColor="@color/white" 
android:textSize="18sp" 
android:gravity="center_vertical" 
android:padding="10dp" 
android:ellipsize="end" 
android:maxLines="1" 

全 


增加 的 省 略 属 性 将 截 去 过 长 的 文本 以 适应 该 条 目 以 一 个 省 略 号 结 来 ， 然 而 maxLines 属性 限制 
了 每 个 条 目的 行 数 为 1。 最 后 ， 在 内 部 的 线性 布局 后 面 但 外 部 线 布 局 结束 之 前 从 清单 5-4 里 加 
上 两 个 更 普通 的 示 图 对 象 ， 来 创建 条 目下 的 水 平 规则 。 外 部 的 线性 布局 设置 高 为 s6dp ， 内 部 


的 则 设置 为 48dp 。 这 两 个 通用 的 view 对 象 将 占用 剩 下 的 重 直 的 2dp 空间 来 建造 一 个 儿 边 。 
清单 5-4 如 下 。 


Listing 5-4. Extra Generic Views for beveled edge 


<LinearLayout> 
<Vvliew 
class="android.view.View" 
android:layout width="fill parent" 
android:layout_ height="1dp" 
android:background="#000"/> 
<Vvliew 
class="android.view.View" 
android:layout width="fill parent" 
android:layout_height="1dp" 
android:background="#333"/> 
</LinearLayout> 


<android.view.View 
class="android.view.View" 
android:layout width="fill parent" 
android:layout_ height="1dp" 
android:background="#000"/> 
<android.view.View 
class="android.view.View" 
android:layout width="fill parent" 
android:layout_ height="1dp" 
android:background="#333"/> 


译 者 注 : 上 面 代码 中 的 控件 view 会 有 些 问题 ， 无 法 解析 背景 色 属 性 。 最 好 改 


成 android.view.View 


加 载 条 目 到 ListView 


现在 刚 修改 的 布局 将 改变 activity 。 打 开 项 目 工 具 窗 并 在 JAVA 源 代码 文件 来 下 找 

到 RemindersActivity 文件 。 它 位 于 com.apress.gerber.reminders 包 里 。 找 到 onCreatel() 方 
法 。 这 是 你 的 类 里 第 一 个 定义 的 方法 。 上 声明 一 个 ListView 成 员 变量 取 名 mListview 按 清单 5-5 
那样 修改 onCreate() 方法 。 你 将 需要 解决 引 入 ListView 和 ArrayAdapter “ 


Listing 5-5. Add List ltems to the ListView 


public class RemindersActivity extends ActionBarActivity { 
private ListView mListView; 
QOverride 
protected void onCreate(Bundle savedIinstanceState) { 
Super ,oncreate(SsavedInstanceState ) ; 
setContentView(R.1layout.activity_reminders); 
mListView = (ListView) ee id.reminders_ list_ view); 


un arrayAdatper is the controller in our 
/model-view-controller relationsnip. 了 
A A arrayAdapter = new ArrayAdapter<String>( 
//context 
this, 
//layout (view) 


R.layout.reminders_row, 

//row (view) 

R.1id.row_ text, 

//data (model) with bogus data to test our listview 

new Stringf ]{"first record", "second record"™, "third record"}); 
mListView.setAdapter(arrayAdapter ); 


} 


//Remainder of the class listing omitted for brevity 


代码 里 用 你 早先 定义 id 属性 查找 Listview 控件 ， 并 且 去 除了 默认 的 条 目 分 隔 绒 ， 这 样 我 们 
早先 自 定 义 的 带 斜 边 分 隔 器 将 会 很 好 地 浑 染 。 这 些 代码 也 创建 了 一 个 带 有 几 个 例子 条 目的 适 
配 绒 。 适 配器 是 一 种 特别 的 JAVA 类 足 义 于 Android SDK 里 ， a 
(模型 ) 里 模型 - 示 图 -控制 器 关系 的 控制 蜂 ， Listview ( 示 图 ) ,还 有 送 配 器 (控制 器 ) 。 适 
ee 。 Adapter 是 ArrayAdapter apo ， 用 来 绑 定 数 
组 到 示 图 里 。 。 在 我 们 的 例 |] 子 里 ， 个 示 图 是 ListView 。 ArrayAdapter 的 构造 函 数 有 三 个 参 
数 。 第 一 个 是 上 下 文 对 象 用 Rs activity 。 适 配器 也 需要 知道 那个 布局 和 布局 里 的 区 
域 或 多 个 区 域 用 于 显示 行 数据 。 为 满足 这 个 要 求 ， 你 要 传送 ee 条 目的 id 到 布局 
里 。 最 后 一 个 参数 是 一 个 字符 串 数组 用 于 表 里 的 每 个 条 目 。 如 果 你 这 时 运行 项 目 ， 将 看 到 给 
到 ArrayAdapter 构造 器 的 那些 值 显示 如 图 5-17。 


当时 和 A 国 的 


Reminders 


first record 


second record 


third record 





图 5-17 ListView 例 子 


按 ctrlt+k | cmd+K 提交 更 改 到 Git 并 境 入 Adds ListView with custom colors 到 提交 信息 里 。 当 
你 工作 于 这 个 项 目 里 ， 用 提交 信息 描述 每 次 提交 的 追加 / 移 除 /更 改 来 执行 增加 提交 到 Git 是 一 个 
不 错 的 体验 。 为 将 来 的 合作 者 及 用 户 保 持 这 个 习惯 来 会 让 事情 变 得 容易 点 ， 来 鉴别 各 次 单独 
的 提交 以 及 以 后 的 构建 记录 。 


设置 溢出 荣 单 的 行为 条 


Android 使 用 一 个 共同 的 可 视 化 元 素 叫 做 行为 条 。 行 为 条 用 于 多 数 app 定 位 导航 和 其 他 选项 以 
让 用 户 执 行 重要 的 任务 。 这 时 运行 这 个 app， 你 可 能 注意 到 一 个 菜单 图 标 则 三 个 坚 直 点 的 那 
个 。 这 些 点 被 叫做 溢出 菜单 。 点 击 这 个 溢出 菜单 图 标 会 产生 只 有 一 个 叫 setting 菜单 项 的 菜 
单 。 这 个 菜单 项 放 在 那 是 新 项 目 向 导 模 板 的 一 部 分 并 且 本 质 上 有 是 一 个 占 位 没有 任何 执行 动 
作 ° RemindersActivity 装载 了 menu_reminders.xml 文件 ， 可 以 在 res/menu 文件 来 下 找到 。 
让 我 们 象 清单 5-6 那 样 对 这 个 文件 做 点 改变 加 上 一 些 新 的 菜单 项 。 


Listing 5-6. New Menu ltems 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
tools:context="com.apress.gerber.reminders.app.RemindersActivity" > 

<item android:id="@+id/action_new" 

android:title="new Reminder" 

android:orderIinCategory="100" 

app:showAsAction="never" /> 

<item android:id="@+id/action_ exit" 

android:title="exit" 

androld:orderInCcategory= 200 

app:showAsAction="never" /> 
</menu> 


在 前 述 的 代码 清单 里 ， title 属性 关联 于 菜单 项 的 显示 文本 。 因 为 我 们 用 硬 代码 设置 这 些 属 
性 值 ，Andorid Studio 将 会 标记 警告 。 按 F2 在 这 些 警 告 间 跳跃 并 按 Alt+Enter 拉 出 智能 建议 。 
你 只 需 简单 地 按 回 车 接受 第 一 个 建议 ， 输 入 新 字符 串 资 源 的 名 称 ， 接 着 马上 弹出 对 话 框 ， 再 
按 回 车 接受 命名 的 资源 。 用 new_reminder 作为 第 一 个 条 目的 名 称 ， 第 二 个 叫 exit 。 


打开 RemindersActivity 并 用 清单 5-7 的 代码 代替 onOptionItemSelected() 方法 。 你 还 需要 解 
决 Log 类 的 引入 。 当 你 点 击 app 上 的 一 个 菜单 项 时 ， 实 时 调用 这 个 方法 ， 传 入 那个 被 点 击 的 菜 
单项 的 引用 。 switch 语 杀 用 MenuItem 的 itemId ， MT 1od 语句 或 终结 结 这 

个 activity ， 取 决 于 哪个 菜单 项 被 点 击 了 。 这 个 例子 用 Log.d() 方法 写 入 文本 到 Android 的 
调试 日 志 里 。 如 果 你 的 app 包 括 多 个 activity 并 且 这 些 activity 比 当 前 activity 先 显 示 ， 
那么 调用 finish() 将 简单 地 把 当前 activity 推出 栈 并 且 把 控制 交 给 下 面 的 activity 。 

为 RemindersActivity 是 这 这 个 app 的 唯一 activity ” finish() 方法 推出 它 将 导致 这 re 
让 。 


Listing 5-7. onoptionsItemSelected( ) Method Definition 


QOverride 
public boolean onOptionsItemSelected(MenuItem item) { 
switch (item.getIitemId()) 1 
case R.id.action_ new: 
//create new Reminder 
Log.d(getLocalClassName(),"create new Reminder™"); 
heewunm erue, 
case R.id.action exit: 
finish(); 
return true; 
default: 
return false,; 


-一 


运行 这 个 app 并 测试 新 的 菜单 选项 。 点 击 new Reminder 菜 单项 并 观察 Android 日 志 里 出 现 的 信 
息 。Android DDMS (Dalvik 调 试 路 拉 服务 ) 窗 将 J 支行 app 的 同时 打开 ， 并 且 
你 将 需要 选择 调试 选项 低 于 Log 级 别 才 可 看 到 调试 日 志 。 运 行 你 的 app 并 与 这 些 菜单 项 互动 。 


~ 


注意 在 你 点 击 New Reminder 杀 单项 时 Android DDMS 出 来 的 日 志 。 节 后 ， 
按 ctrl+k | cmd+K 并 提交 你 的 代码 到 Git， 用 Adds new reminder and exit menu options 作 为 


昌 产 /一 
提交 信 息 


保持 提醒 


为 Reminders 这 个 app 需 要 保存 提醒 清单 ， 你 将 需要 一 个 保存 策略 。Android SDK 和 运行 时 
系统 提供 了 一 个 内 建 的 数据 库 引 擎 叫 SQLite， 它 设计 为 有 限 记 忆 体 环境 并 很 适合 于 移动 设 
备 。 这 节 涵 括 了 SQLite 数 据 库 并 浏览 怎么 保存 提醒 清单 。 我 们 的 东 略 将 包括 一 个 数据 模型 ， 
一 个 数据 库 代 理 类 ， 还 有 一 个 游标 适配器 ( cursorAdapter )°。 这 个 模型 将 维持 数据 读 写 到 数据 
库 。 代 理 将 是 一 个 适配器 类 将 把 从 app 简 单调 用 转换 为 到 数据 库 API 调 有 用。 也 后 ， 游 标 适配器 
将 扩展 为 一 个 标准 的 Android 类 用 于 以 抽象 方式 处 理 数 据 访 问 。 


数据 模型 


让 我 们 开始 创建 数据 模型 。 右 击 com.apress.gerber.reminders 包 并 选择 New > Java Class 。 

命名 这 个 类 为 Reminder 并 按 回 车 。 如 清单 5-8 那 样 装 被 这 个 类 。 这 是 一 个 简单 的 POJO (简单 
的 老 JAVA 对 象 ) 定义 了 几 个 实例 变量 和 相应 的 getter 及 setter 方法 。 Remider 类 包含 了 和 
个 整 型 的 ID ， 字 符 串 变量 ， 和 数值 化 的 重要 值 。 ID 是 用 于 标记 每 个 提醒 的 唯一 数字 。 字 符 
串 则 保存 了 提醒 的 文本 。 重 要 值 是 一 个 数值 化 的 指示 器 用 来 标志 一 个 独立 的 提醒 是 否 重 要 (1= 
重要 ，0= 不 重要 )。 我 们 更 愿意 用 整 型 而 不 是 布尔 值 是 因为 SQLite 数 据 库 没有 布尔 数据 类 型 。 


Listing 5-8. Reminder Class Definition 


public class Reminder { 

private int mId; 

private String mContent; 

private int mImportant; 

public Reminder(int id, String content, int important) { 
mId = 1d; 

mImportant = important,; 
mContent = content,; 


} 
public int getId() { 
return mId; 


public void setId(int 1d) 1 
mId = 1d; 


public int getIimportant() { 
return mImportant, 


public void setImportant(1Int important) { 
mImportant = Important ，; 


} 
public String getContent() { 
return mContent, 


public void setContent(String content) { 
mContent = content,; 
} 


现在 你 将 创建 一 个 数据 代理 。 再 次 ， 这 个 代理 将 转换 简单 的 应 用 调用 为 低级 别 的 SQLite API 
调用 。 在 com.apress.gerber.reminders 包 里 新 建 一 个 类 叫 RemindersDbAdapter 。 把 清单 5-9 的 
代码 直接 加 入 到 这 个 新 类 里 。 当 你 解析 导入 时 ， 发 现 D atabaseHelper 并 没 在 Android SDK 
里 。 我 们 将 在 后 面 的 步骤 里 定义 DatabaseHelper 。 这 些 代码 定义 了 列 名 称 和 索引 ; 一 个 TAG 
作 日 志 ; 两 个 上 下 文 对 外 对 象 ; 和 一 个 SQL 语 句 用 于 创建 数据 库 。 


Listing 5-9. Code to be placed inside the RemindersDbAdapter Class 


//these are the column names 
public static final String COL ID = "_ id"; 
public static final String COL_ CONTENT = "content",， 
public static final String COL_IMPORTANT = "Important :; 
//these are the corresponding indices 
public static final int INDEX ID = 0; 
public static final int INDEX CONTENT = INDEX ID + 1; 
public static final int INDEX IMPORTANT = INDEX ID + 2; 
//uUsed for logging 
private static final String TAG = "RemindersDbAdapter"; 
private DatabaseHelper mDbHelper; 
private SQLiteDatabase mDb; 
private static final String DATABASE NAME = "dba_remdrs"; 
private static final String TABLE_ NAME = "tbl remdrs"; 
private static final int DATABASE VERSION = 1; 
private final Context mCtx; 
//SQL statement used to create the database 
private static final String DATABASE_CREATE = 
"CREATE TABLE jf not exists ”+ TABLE NAME + "~ ( "+ 
COL_ID + " INTEGER PRIMARY KEY autoincrement, ”二 
COL CONTENT 十 TEXT, “+ 
COL_IMPORTANT + " INTEGER );"; 


SQLite API 


DatabaseHelper 总 一 个 SQLite API 类 ， 用 于 打开 和 关闭 数据 库 。 它 用 到 了 上 下 坟 Context ， 
这 是 一 个 抽象 的 Android 类 以 提供 到 Android 操 作 系 统 的 访问 。 patabaseHelper 是 一 个 用 户 自 
定义 类 ， 且 必须 由 你 来 定义 。 用 清单 5-10 实 施 DatabaseHelper 类 ， 作 

为 RemindersDbAdapter 的 内 部 类 。 把 这 些 代 码 放 到 RemindersDbAdapter 后 段 ， 但 在 类 结束 的 
花 括 号 的 前 面 。 


Listing 5-10. RemindersDbAdapter 


private static class DatabaseHelper extends SQLiteOpenHelper { 
DatabaseHelper(Context context) { 
super(context, DATABASE NAME, null, DATABASE_ VERSION); 





@Override 

public void onCreate(SQLiteDatabase db) { 
Log.w(TAG, DATABASE_ CREATE); 
db .execSQL (DATABASE_CREATE ) ; 


@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 1 
Log.w(TAG, a database from version ”+ oldVersion + " to " 
+ NewVersion + ", which will destroy all old data"); 
db .execSQL( -DROP TABLE IF EXISTS ”+ TABLE_NAME ) ， 
onCreate( db); 


DatabaseHelper 继承 于 QLiteopenHelper ， 用 于 以 特殊 的 回调 方法 来 维护 数据 库 。 回 调 方 法 是 
运行 时 环境 在 应 用 的 整个 生命 周期 内 都 调用 的 方法 ， 并 且 它 们 用 到 sQLitepatabase db 变量 提 
供 SQL 命 令 的 执行 。 在 构造 器 里 数据 库 就 被 初始 化 了 。 构 造 器 传递 数据 库 名 和 和 版 本 到 它 的 父 
类 ; 然后 父 类 做 数据 库 的 设置 繁杂 工作 。 当 需要 建立 数据 库 时 oncreate() 方法 被 运行 时 自动 
调用 。 这 个 操作 只 运行 一 次 ， 当 app 首 次 启动 并 且 数 据 库 还 未 创建 时 。 onupgrade() 方法 是 在 
数据 库 更 新 时 被 调用 ， 例 如 假如 开发 者 改变 纲要 。 如 果 你 改变 数据 库 的 纲要 ， 

给 DATABASE_VERSION 增加 1， 然 后 onupgrade() 会 处 理 剩 下 的 事情 。 如 果 你 总 

给 DATABASE_VERSION 加 1， 你 的 app 将 前 溃 即 便 在 调试 构建 模式 下 。 在 前 述 的 MJ ， 在 运 

行 oncreate() 方法 之 前 我 们 运行 一 个 SQL 命令 来 移 除 数据 库 里 唯一 的 表单 ， 以 方便 重建 表 
单 o 

清单 5-11 演 示 了 用 patabaseHelper 来 打开 和 关闭 数据 库 。 构 造 器 保存 了 上 下 文 的 一 个 实例 ， 
它 会 被 传送 到 DatabaseHelper 。 open( ) 方 法 初始 化 helper 并 用 它 得 到 一 个 数据 库 的 实例 ， 让 
到 close() 方法 用 于 关闭 数据 库 。 把 这 些 代 码 加 入 到 RemindersDbAdapter 类 里 ， 在 所 有 成 员 
变量 之 后 和 DatabaseHelper 内 部 类 之 前 。 当 你 解析 导入 时 ， 


用 android.database.SQLException 类 。 


Listing 5-11. Database Open and Close Methods 


public RemindersDbAdapter(Context ctx) { 
this.mCtx = ctx; 

} 

//open 

public void open() throws SQLException { 
mDbHelper = new DatabaseHelper (mCtx ) ; 
mDb = mDbHelper.getwritableDatabase( ); 

-Wn 

//Close 

public void close() { 
if (mDbHelper != null) 1 

mDbHelper.close!( ); 

yj 


清单 5-12 包 含 了 所 有 处 理 在 tbl remdrs 表 单 里 创建 ， 读 取 ， 更 新 ， 和 删除 Reminder 对 象 的 操 
作 。 通 常 参考 CRUD 操 作 ; CRUD 即 代表 创建 ， 读 取 ， 更 新 ， 删 除 。 加 入 这 些 代码 
到 RemindersDbAdapter 类 的 close() 方法 之 后 。 


Listing 5-12. Database CRUD Operations 


//CREATE 
//nNnote that the id will be created for you automatically 
public void createReminder (String name, boolean important) 1 
ContentValues values = new ContentValues(); 
values.put(COL_ CONTENT, name); 
values.put(COL IMPORTANT, important ? 1 : 0); 
mDb .insert(TABLE NAME, Null, values); 


//overloaded to take a reminder 

public long createReminder (Reminder reminder) 1 
ContentValues values = new ContentValues(); 
values.put(COL _ CONTENT, reminder .getContent()); // Contact Name 
values.put(COL_ IMPORTANT, reminder .getImportant()); // Contact Phone Number 
// Inserting Row 
return mDb.insert(TABLE NAME, Null, values); 


//READ 
public Reminder fetchReminderById(int id) { 
Cursor cursor = mDb.query(TABLE NAME, new String[ |]{COL_ID, 
COL_CONTENT, COL_IMPORTANT}, COL_ID + "=?", 
new String[]{String.valueof(id)}, null, null, null, null 
); 
if (cursor != null) 
cursor.moveToFirst(); 
return new Reminder( 
cursor.getInt(INDEX_ID), 
cursor.getString(INDEX CONTENT), 
cursor.getInt(INDEX IMPORTANT) 


) 


public Cursor fetchAllReminders() 1 
Cursor mCursor = mDb.query(TABLE NAME, new String[ ]{COL_ID, 
COL_CONTENT, COL_IMPORTANT}, 
RO nn 
); 
if (mCursor != null) { 
mCursor .moveToFirst(); 


return mCursor,; 


//UPDATE 
public void updateReminder (Reminder reminder) 1 
ContentValues values = new ContentValues(); 
values.put(COL CONTENT, reminder .getContent()); 
values.put(COL_ IMPORTANT, reminder .getImportant( ) ) ; 
mDb .update(TABLE NAME, values, 
COL_ID + "=?", New String[ j{String.valueof(reminder .getId())}); 


/7DELETE 
public void deleteReminderById(int nId) { 
mDb.delete(TABLE NAME, COL_ ID + "=?", New String[ ]{String.valueof(nId)}); 


public void deleteAllReminders() { 
mDb .delete(TABLE_ NAME, null, null); 
了 


每 个 方法 都 用 到 了 seQLitepatabase mDb 变量 来 生成 和 执行 SQL 语句 。 如 果 你 熟悉 SQL ， 你 会 


育 到 这 些 SQL 语 妃 将 由 INSERT ， SELECT ，UPDATE , 或 DELETE 组 成 。 


两 个 创建 方法 用 到 了 特别 的 contentvalues 对 人 象 ， 这 个 是 数据 载体 用 于 在 insert 方法 里 传送 
数据 值 到 数据 库 对 象 。 在 insert 语句 里 数据 库 最 终 将 转换 这 些 对 有 象 到 数据 库 。 有 两 个 读 方 
法 ， 一 个 用 于 引出 单个 提醒 另 一 个 则 引出 一 个 游标 以 遍历 所 有 的 提醒 。 了 晚点 在 一 个 特别 

的 Adapter 类 里 你 将 用 到 游标 。 


更 新 方法 象 第 二 个 创建 方法 。 无 论 怎样 ， 这 个 方法 调用 了 找 层 的 数据 库 对 象 的 更 新 方法 ， 那 
个 将 生成 并 执行 一 个 更 新 SQL 语 名 而 不 是 一 个 插入 语句 。 


最 后 ， 有 两 个 删除 方法 。 第 一 个 针对 特定 的 提醒 用 id 参数 和 数据 库 对 象 来 生成 和 执行 一 条 
删除 语句 。 第 二 个 方法 需要 数据 库 生成 并 执行 一 条 删除 语句 来 移 除 所 有 表单 里 的 提醒 。 


， 有 两 个 删除 方法 。 第 一 个 针对 特定 的 提醒 用 id 参数 和 数据 库 对 象 来 生成 和 执行 一 条 
出 除 语 句 。 第 二 个 方法 需要 数据 库 生 成 并 执行 一 条 删除 语句 来 移 除 所 有 表单 里 的 提醒 。 


这 时 ， 你 需要 一 个 手段 从 数据 库 提出 提醒 并 放 入 到 Listview 。 清 单 5-13 演 示 了 必要 的 逻辑 ， 
通过 继承 之 前 你 看 到 的 特别 的 Adapter Android 类 来 绑 定 数据 库 值 到 单独 的 行 对 象 。 创 建 一 个 
新 类 RemindersSimpleCursorAdapter 在 com.apress.gerber.reminders 包 下 ， 并 完成 处 理 代 码 . 


刀 


当 解 析 导 入 类 时 ， 使 用 android. support .v4.widget.SimpleCursorAdapter 类 。 


Listing 5-13. R emindersSimplecursorAdapter Code 





public class Remind 
public Reminde ) 
fromerntel to nt flag5) { 
super(context, layout, c, from, to, flags); 


ter extends SimpleCursorAdapter { 
ter(Context context, int TI Cursor ce Stringl 





ewHolder class 
@Override 
public View newView(Context context, Cursor cursor, ViewGroup parent) 1{ 
return super.newView(context, cursor, parent); 


@Override 
public void bindView(View view, Context context, Cursor cursor) 1 
super .bindView(view, context, cursor); 
ViewHolder holder = (ViewHolder) view.getTag( ); 
if (holder == null) { 
holder = new ViewHolder( ); 
holder.colIimp = cursor.getColumnIndexOrThrow(RemindersDbAdapter .COL IMPORT 
ANT); 
holder.listTab = view.findViewById(R.id.row tab ) ; 
view.setTag(holder ) ; 


If (cursor.getIint(holder.colIimp) > 0) { 
holder.listTab.setBackgroundColor(context.getResources().getColor(R.color. 
orange ) ); 
} else { 
holder .listTab.setBackgroundColor(context.getResources().getColor(R.color. 
green ) ) ; 


static class ViewHolder { 
//store the column index 
int colImp; 
//store the view 


View listTab., 


我 们 用 适配器 把 所 有 提醒 登记 到 Listview 。 在 运行 时 中 ， Listview 将 重复 调用 在 适配器 里 
的 bindview() 方法 ， 以 单独 的 示 图 对 象 作 为 用 户 装 载 蜂 ， 且 在 清单 里 滚动 。 填 入 这 些 清单 条 
目 到 示 图 里 是 适配器 的 工作 。 在 这 个 例子 代码 里 ， 我 们 使 用 了 适配器 的 子 

类 SimplecursorAdapter 。 这 个 类 用 了 一 个 游标 对 象 ， 它 保存 着 跟踪 表单 里 的 行 轨迹 


这 里 你 看 到 了 一 个 viewHolder 模式 的 例子 。 这 是 一 个 容易 认识 的 Android 模 式 ， 每 

个 viewHolder 对 象 含有 一 个 示 图 的 标签 。 用 数据 源 〈 在 这 个 例子 里 是 cursor ) 的 值 ， 这 个 
对 象 加 载 清单 里 的 示 图 对 象 。 ViewHolder 定义 为 一 个 内 部 静态 类 ， 有 两 个 实例 变量 ， 一 个 用 
于 索引 重要 的 表单 项 另 一 个 用 于 在 布局 里 定义 的 row tab 示 图 。 


bindview() 方法 开始 于 父 类 在 示 图 里 从 游标 到 | 元 率 的 map 值 方法 的 调用 。 然 后 检查 看 

(holder) 是 否 附 有 一 个 标签 还 是 有 必要 创建 一 个 新 的 (holder) 。 然 后 bindview() 方法 用 
重要 列 索 引 和 早先 定义 的 row_tab 配置 容器 的 实例 变量 。 在 容器 被 发 现 或 配置 后 ， 从 当前 提 
醒 的 cOL_IMPORTANT 常量 秋 决 定 row_tab 用 什么 磊 色 。 这 个 例子 用 了 新 的 柳 色 ， 那 个 你 要 加 


到 colors.xml : <color name="orange">#ffff381a</color> ° 


早先 你 用 了 ArrayAdapter 来 管理 模型 和 示 图 之 间 的 关系 ° SimpleCursorAdapter 也 是 用 同样 的 
模式 ， 虽 然 它 的 模型 是 SQLite 数 据 库 。 将 清单 5-14 更 改 到 你 


的 RemindersDbAdaper 和 RemindersSimpleCursorAdapter 类 里 。 


Listing 5-14. RemindersActivity Code 


public class RemindersActivity extends ActionBarActivity { 

private ListView mListView; 

private RemindersDbAdapter mDbAdapter; 

private RemindersSimpleCursorAdapter mCursorAdapter ; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
Super ,oncreate(SavedInstanceState ) ; 
setContentView(R.1layout.activity_reminders ) ; 
mListView = (ListView) findViewById(R.id.reminders_ list view); 
mListView.setDivider (null); 
mDbAdapter = new RemindersDbAdapter(this),; 
mDbAdapter .open( ); 
Cursor cursor = lt ce Ee 
string[] from = = New cr 

RemindersDbAdapter .COL_CONTENT 


, 


int[] to = new int[]{ 
R.1id.row_ text 


}; 
i ei = New RemindersSimpleCursorAdapter( 


RemindersActivity, this, 


R. layout， ee 
cursor， 
From 
to 
0 
/ the , ste 


mListView.setAdapter (mCursorAdapter ) ; 


这 时 候 如 果 你 运行 app， 你 还 是 看 不 到 清单 里 有 任何 东西 ; 屏幕 完全 是 空 的 ， 因 为 你 最 后 的 修 
改 在 例子 的 数据 部 分 插入 了 数据 库 功 能 。 按 ctrl+k | cmd+k 并 提交 的 修改 ， 提 交 信 息 : Adds 
SQLite database persistence for reminders and a new color for important reminders。 聪 明 点 
的 话 ， 你 可 能 想 弄 清楚 怎么 用 新 的 RemindersDbAdaper 把 例子 里 的 条 目 加 回来 。 这 将 在 下 章 描 
述 ， 你 可 以 继续 看 下 去 并 检查 下 作业 了 。 


致 此 ， 你 有 了 个 成 熟 的 Android 应 用 。 在 这 章 ， 你 学 会 了 怎样 设置 第 一 个 Android 项 目 并 用 Git 
控制 代码 。 你 也 探索 了 怎么 编辑 Android 布 局 ， 用 设计 或 文本 模式 。 你 也 看 到 建立 一 个 在 动作 
条 里 的 溢出 菜单 。 这 和 草 的 也 后 探索 了 Listview 和 Adapter ， 以 及 绑 定 数据 到 内 建 的 SQLite 数 
据 库 。 在 接 下 来 的 章节 里 ， 增 加 创建 和 编辑 提醒 的 功能 ， 你 将 完成 这 个 app。 


大 大 SN 


第 六 章 : Reminders 实 验 : 第 二 部 分 


~ 


译 者 : qiangxcn 
来 源 : Learn Android Studio 汉化 教程 第 六 章 : Reminders 实 验 : 第 二 部 分 


这 章 涵 括 了 通过 对 话 框 捕获 用 户 输入 。 也 继续 演示 适配器 及 SQLite 数 据 库 的 使 用 。 这 和 草 里 ， 
我 们 将 完成 从 第 五 章 开 始 的 例子 。 


增加 /删除 提醒 


第 五 章 里 这 个 例子 的 屏幕 还 没有 任何 提醒 。 为 了 让 布局 看 到 提醒 清单 ， 当 app 启 动 时 加 载 些 提 
醒 的 例子 上 去 ， 这 是 很 有 用 的 。 如 果 你 想 挑 战 这 章 处 理 过 程 ， 上 比较 下 清单 6-1 和 你 的 代码 。 清 
单 6-1 检 查 是 否 有 保存 的 实例 ， 如 果 有 ， 处 理 将 设置 例子 数据 。 为 此 ， 代 码 调 用 了 些 
DatabaseAdapter 的 方法 ; 一 个 是 清除 所 有 的 提醒 ， 另 一 个 则 是 加 入 些 提醒 。 


Listing 6-1. Add Some Example Reminders 


public class RemindersActivity extends ActionBarActivity 1 
private ListView mListView; 
private RemindersDbAdapter mDbAdapter; 
private RemindersSimpleCursorAdapter mCursorAdapter; 
QOverride 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.1layout.activity_reminders); 
mListView = (ListView) findViewById(R.id.reminders_ list view); 
mListView.setDivider (null); 
mDbAdapter = new RemindersDbAdapter (this); 
mDbAdapter .open( ); 
if (SavedInstanceState == null) { 
//Clear all data 
mDbAdapter.deleteAllReminders( ); 
//Add some data 
mDbAdapter.createReminder("Buy Learn Android Studio", true); 
mDbAdapter.createReminder("Send Dad birthday gift", false); 
mDbAdapter.createReminder("Dinner at the Gage on Friday", false); 
mDbAdapter.createReminder("String squash racket", false); 
mDbAdapter.createReminder("Shovel and salt walkways", false); 
mDbAdapter.createReminder("Prepare Advanced Android syllabus", true); 
mDbAdapter.createReminder("Buy new offijice chair", false); 
mDbAdapter.createReminder("Call Auto-body shop for quote", false); 
mDbAdapter.createReminder("Renew membership to club", false); 
mDbAdapter .createReminder("Buy new Galaxy Android phone", true); 
mDbAdapter.createReminder("Sell old Android phone - auction", false); 
mDbAdapter.createReminder("Buy new paddles for kayaks", false); 
mDbAdapter.createReminder("Call accountant about tax returns", false); 
mDbAdapter.createReminder("Buy 300,000 shares of Google", false); 
mDbAdapter.createReminder("Call the Dalai Lama back", true); 


//Removed remaining method code for brevity... 


} 


//Removed remaining method code for brevity... 


有 几 个 createReminder() 方法 的 调用 ， 每 个 都 是 用 一 个 字符 串 作 提醒 文本 》 以 及 一 个 布尔 值 
标记 提醒 是 否 重 要 。 我 们 设置 一 些 实体 值 让 显示 好 看 点 。 选 中 createReminder() 方法 调用 的 
代码 块 按 以 ctrl+ALt+M | Cmd+Alt+M 汲取 方法 ， 如 图 6-1 示 。 这 是 一 个 通过 重 构 菜单 和 快捷 键 
结合 的 重 构 操作 。 输 入 insertsomeReminders 作为 方法 名 并 确认 。 这 些 代码 块 将 以 析出 的 方法 
代替 ， 这 些 代 码 块 将 在 方法 体 里 了 。 


Nothing to show 


signature Preview 
private void insertSormeRemindersl) 























图 6-1 析出 方法 对 话 框 ， 创 建 一 个 insertsomeReminders() 方法 


运行 9pp 看 到 的 界面 ， 拥 有 提醒 例子 了 。 你 的 app 应 该 看 起 来 象 图 6-2 的 截屏 那样 。 有 些 提 醒 显 
示 绿 色 的 行 选项 卡 ， 而 那些 重要 的 提醒 则 显示 橙色 行 选 项 卡 。 提 交 你 的 更 改 到 Git， 备 注 Adds 
Example reminders ° 
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图 6-2 插入 了 提醒 例子 的 实时 运行 


响应 用 户 的 互动 


没有 app 不 响应 输入 。 在 这 节 ， 你 将 加 入 响应 点 击 事件 的 逻辑 并 且 最 终 允 许 用 户 编辑 独立 的 提 
醒 。 在 app 里 的 主要 元 素 是 Listview ， 一 个 Android view 的 子 类 。 直 致 此 刻 ， 除 了 把 它 放 到 
布局 里 ” 你 还 没 做 过 其 它 的 什么 ° android.view.View 是 所 有 你 看 到 的 所 有 屏幕 元 素 的 超 类 


把 清单 6-2 的 代码 加 到 RemindersActivity 的 oncreate() 方法 后 面 ， 即 在 方法 结束 花 括 号 之 

前 ， 并 解决 导入 类 的 问题 。 这 是 一 个 匿名 内 部 类 实现 onItemclickListener 接口 ， 它 只 有 一 个 
方法 ， onitemclicked() 。 这 个 对 象 将 用 于 你 互动 与 它 所 跟踪 的 Listview 元 素 的 实时 运行 。 

当 用 户 点 击 ListView 时 ， 匿 名 内 部 类 的 oncreate() 方法 将 被 调用 。 我 们 定义 一 个 吐 司 ， 一 个 
Android SDK 的 类 。 调 用 Toast.makeText() 将 导致 在 屏幕 上 弹出 一 个 小 菜单 ， 显 示 出 你 传送 给 
方法 的 文本 。 你 可 以 看 到 清单 6-2 的 代码 ， 作 为 快速 正确 使 用 吐 司 的 指引 。 


注意 : 吐 司 信息 可 能 在 一 些 设备 上 被 隐藏 。 另 一 个 替代 途径 是 记录 一 个 日 志 人 信息， 用 Android 
的 日 志 记 录 器 ， 那 个 在 第 十 二 章 会 有 祥 述 。 


Listing 6-2. Set an onItemclickListener With a Toast 


//when we click an individual Item In the listview 
mListView.setOonItemClickListener(new AdapterView.OnIitemClickListener() { 
QOverride 


public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 
Toast .makeText (RemindersActivity.this, "clicked ”+ position, 
Toast .LENGTH_SHORT) . show( );， 
}); 


点 击 屏 幕 第 一 个 提醒 将 调用 onItemclick() 方法 ， 在 清单 里 的 位 置 是 0， 所 以 索引 是 0。 这 个 加 
辑 将 弹出 位 置信 息 的 文本 ， 如 图 6-3 所 示 。 


Call Auto-body shop for quote 


clicked 0 
Renew memMmge er to club 
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图 6-3 点 击 第 一 条 提醒 弹出 的 吐 司 信息 


用 户 对 话 框 


大 家 所 熟悉 的 一 些 点 击 事件 ， 现 在 你 可 增强 点 击 监听 为 显示 一 个 对 话 框 。 用 清单 6-3 的 代码 赫 
换 所 有 的 onItemclick() 方法 。 解 决 导 入 时 ， 请 用 android.support.v7.app.AlertDialog 类 。 


Listing 6-3. onItemclick( ) Modifications to Allow Edit/Delete 


public void onItemClick(AdapterView<?> parent, View view, final int masterListPosition 
; long id) { 
AlertDialog.Builder builder = new AlertDialog.Builder (RemindersActivity.this); 
ListView modeListView = new ListView(RemindersActivity.this); 
String[|] modes = new String[|] { "Edit Reminder", "Delete Reminder™" }; 
ArrayAdapter<String> modeAdapter = new ArrayAdapter<>(RemindersActivity.this, 
android.R.1layout.simple list item 1, android.R.id.text1i, modes); 
modeListView.setAdapter (modeAdapter ) ; 
builder.setView(modeListView); 
final Dialog dialog = builder.create( ); 
dialog.show( ); 
modeListView.setOnIitemClickListener(new AdapterView.OnIitemClickListener() { 


QOverride 
public void onItemClick(AdapterView<?> parent, View view, int position, long 1 
d) + 
9 a == 0) { 
Toast .makeText (RemindersActivity.this, "edit " 
二 Dy Toast .LENGTH_SHORT).. show( ) ; 
} else “a 
Toast.makeText (RemindersActivity.this, "delete " 
+ masterListPosition, Toast.LENGTH_SHORT).show(); 
dialog.dismiss(); 
} 
}); 


在 处 理 代 码 里 你 看 到 了 另 Android 类 在 工作 ， AlertDialog.Builder 。 这 个 类 创建 器 裔 入 
在 AlertDialog 类 里 ， 有 是 个 静态 类 ， 它 用 于 创建 AlertDialog ° 


入 ListView 以 及 用 ArrayAdapter 咀 入 条 目 到 Listvite 。 
你 可 想起 第 五 草 的 这 种 模型 。 这 个 Wom eb (选项 ) 的 数组 ， 编 辑 


提 het oe . 和 | ListVview 之 前 ， 这 个 是 ， 轮 流 地 ， 传 送 合 AlertDialog. Builder ° 
这 个 创建 器 然后 些 选项 清单 创建 并 显示 一 个 对 话 框 。 


注意 下 代码 清单 6-3 最 后 的 选择 部 分 。 有 点 象 之 前 的 onItemclickListener() ; 不 管 怎 样 ， 我 们 
附加 了 一 个 modeListView 的 监听 器 ， 那个 在 当前 OnItemClickListener 里 创建 的 。 你 看 到 的 是 
带 有 onItemclickListener 的 Listview ( 指 的 是 activity_reminders.xml 里 

的 reminders_list_view ) ( 译 者 : 在 它 的 onItemClick 方法 里 ) 创建 了 另 一 

个 modeListView 还 有 另 一 个 远 入 的 OnItemClickListener 来 响应 来 目 modeListView 的 选项 点 


十 事件 


内 误 的 点 击 监听 器 弹出 一 个 吐 司 信息 来 指示 是 编辑 还 是 删除 所 点 击 的 条 目 。 它 也 重 命名 来 自 
外 部 调用 者 onItemclickListener 的 位 置 参 数 叫 做 masterListPosition 来 区 分 内 置 

的 onItemclickListener 的 位 置 参数 。 这 个 masterListposition 用 于 吐 司 指明 哪 条 提醒 被 用 于 
可 能 的 编辑 或 删除 。 最 后 ，dialog.dismiss() 方法 调用 于 点 击 监听 器 ， 用 来 完全 移 除 对 话 
框 。 


运行 一 下 来 测试 新 特性 如 图 6-4 所 示 。 点 击 一 条 提醒 接着 在 弹出 对 话 框 再 点 编辑 或 删除 。 如 果 
吐 司 里 报告 的 提醒 位 置 和 你 ， oa 再 确认 一 下 你 吐 司 里 追加 masterListPosition 值 

而 不 是 postion 。 按 ctrl+k | cmd+k 提交 更 改 到 Git， 并 附 上 信息 Adds a ListView dialog for 

Indlvidual list items ° 
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图 6-4 模拟 删除 一 条 提醒 


提供 多 选 上 下 文 菜 


随 着 这 个 app 逐 渐 成 形 ， 现 在 将 达成 这 种 特性 : 在 一 次 操作 里 允许 多 选 提醒 条 目 用 于 编辑 。 这 
种 特性 只 能 在 API1 11 或 更 高 版 本 上 才 有 效 。 你 将 通过 使 用 资源 载 入 协定 来 有 条 件 地 达成 这 种 特 
性 。 这 个 处 理 将 在 这 章 稍 后 解释 并 且 第 8 章 有 所 有 的 细节 。 你 也 将 需要 包含 一 个 运行 时 检查 看 
看 是 否 支持 这 种 特性 。 


为 提醒 行 条 目 创建 另 一 个 备用 的 布局 。 打 开 项 目 工 具 窗 口 在 资源 来 上 右 击 带 出 来 的 上 下 文 。 
选择 新 的 Android 资 源 文件 命名 为 r eminders row ， 如 图 6-5 示 。 
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图 6-5 新 资源 文件 reminders row 


选择 资源 类 型 为 布局 ， 这 样 就 自动 改变 目录 名 为 layout 。 在 有 效 限定 词 部 分 选择 相应 的 版 本 
然后 双击 ( >> ) 双 V 纹 章 按钮 增加 到 选择 的 限定 词 里 。 输 入 11 作 为 平台 API 级 别 并 注意 到 目录 名 
更 新 了 ， 并 反映 了 选择 的 限定 词 版 本 。 那 叫 资源 限定 并 且 它 们 整合 于 运行 时 里 ， 让 你 可 以 为 

特别 的 设备 和 和 平台 版 本 定制 你 的 用 户 界面 。 按 回 车 〈 或 点 OK) 接受 这 个 新 资源 限定 目录 并 继 
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续 。 如 果 你 打开 项 目 工具 窗 并 设 为 Android 示 图 ， 如 图 6-6， 你 将 看 到 layout 文件 夹 下 所 有 
的 reminders_row 布局 文件 在 一 起 。 还 有 ，Android 示 图 的 项 目 工具 窗 让 相关 联 的 文件 聚集 在 
一 起 使 你 有 效 地 管理 它们 。 
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图 6-6 聚集 的 布局 


复制 整个 原始 的 reminders_row 布局 并 粘贴 到 刚 新 建 版 本 11 的 布局 里 。 现 在 修改 内 层 的 水 平 线 
性 布局 的 背景 色 属 性 如 下 : 


android:background="?android:attr/activatedBackgroundIndicator" 


这 个 值 分 配 背 景色 属性 带 前 级 ?android:attr/ ， 这 是 参考 定义 于 Android SDK 里 的 一 种 风 
格 。Android SDK 提 供 了 很 多 这 样 的 预定 义 属 性 ， 并 且 你 可 以 使 用 它们 到 你 的 app 上 。 在 多 选 
模式 时 activatedBackgroundIndicator 属性 使 用 了 系统 定义 的 有 效 痛 景 色 。 


目标 于 早期 的 SDK 


现在 你 将 学 习 如 何 引 入 一 个 平台 依赖 的 特性 。 打 开 项 目 工具 窗 并 打开 在 Gradle 剧 本 区 下 面 的 
app 模 块 build.gradle 文件 ( 它 会 在 第 二 个 入 口 里 ) 。Gradle 文 件 含 有 编译 的 构建 逻辑 和 app 
的 包装 。 参 照 你 的 app 所 支持 的 平台 所 有 配置 存在 于 这 些 特别 的 文件 里 (第 十 三 草 深度 探索 了 
Gradle 构 建 系统 ) 。 注 意 到 最 低 SDK 版 本 设置 为 8， 这 让 你 的 app 可 以 运行 在 99% 的 Android 设 
备 上 。 现 在 我 们 将 创建 的 这 个 特性 需要 最 低 SDK 版 本 是 11。 涵 括 这 节 的 代码 和 特性 将 允许 用 
户 运 行 在 SDK11 或 更 高 版 本 带 来 的 更 先进 的 特性 ， 叫 上 下 文 动作 模式 。 而 且 ， 低 于 SDK11 的 
将 不 会 有 这 个 特性 ， 但 更 重要 的 是 ， 他 们 的 app 不 会 因此 而 崩溃 。 


加 入 上 下 文 动作 模式 


接 下 来 介绍 的 多 选 模 式 的 上 下 文 动作 模式 菜单 ， 是 一 个 动作 清单 可 用 于 所 有 选择 项 的 上 下 
文 。 加 载 一 个 新 的 菜单 资源 在 res/menu 目 录 上 右 击 选择 New > Menu 资源 文件 并 命名 
为 cam menu 。 以 下 列 代码 清单 完成 它 : 


<?xml] version="1.0" encoding="utf-8"?> 

<menu xmlns:android="http://schemas.android.com/apk/res/android";> 
<item android:id="@+id/menu_item delete reminder" 
android:1icon="@android:drawable/ic menu_ delete" 
android:title="delete”" /> 

</menu> 


这 个 资源 文件 为 上 下 文 菜单 定义 了 唯一 的 删除 动作 条 目 。 这 里 你 也 正 用 了 一 点 不 同 的 属性 
值 。 这 个 特别 的 属性 象 之 前 的 背景 色 属 性 一 样 也 是 访问 Android 内 建 的 缺 省 值 。 不 管 怎 样 ， 在 
那 前 级 ?android:attr/ prefix 只 用 于 参考 风格 属性 。 在 这 用 在 属性 上 的 语法 参照 一 个 稍 有 不 
同 的 格式 。 用 at 符号 @ 触发 一 个 到 资源 值 查询 的 命名 空间 。 你 可 以 用 这 种 方式 访问 变量 命名 
空间 。Android 命 名 空间 是 所 有 内 建 Android 值 所 在 的 地 方 。 用 这 个 命名 空间 是 多 种 变量 资源 所 
存在 的 如 drawable ,string 以 及 布局 。 当 你 用 了 6@rid 为 前 级 ， 它 会 创建 一 个 新 的 ID 在 你 的 
项 目的 R.java 文件 里 ， 且 当 你 用 到 @id 前 级 ， 它 会 查找 Andriod SDK 的 R.java 文件 存在 

的 ID 。 这 个 例子 里 定义 了 一 个 新 的 ID 名 ， menu_item_delete_reminder ， 它 结合 于 菜单 选 
项 。 它 也 从 android:drawable 命名 空间 里 拉 出 一 个 图 标 ， 作 为 它 的 图 标 。 


用 新 的 上 下 文 菜单 和 一 个 备用 的 布局 运行 于 API 11 或 更 高 版 本 ， 你 可 以 加 载 一 个 有 条 件 的 检查 


以 允许 带 有 上 下 文 动 作 菜单 的 多 选 模式 打开 RemindersActivity 并 加 上 下 面 的 代码 
到 oncreate 方法 的 后 面 。 


if (Build.VERSION.SDK_INT >= Build.VERSION CODES.HONEYCOMB) { 


} 


构建 类 从 android.os 包 里 导入 并 且 给 你 访问 一 系列 的 常量 值 ， 那些 可 用 于 以 指定 的 API 级 别 
来 匹配 设备 。 在 这 个 例子 里 ， 你 期 望 AP| 级 别 等 于 或 高 于 ONEYCOMB 而 它 实际 包含 整数 
11。 把 清单 6-4 的 代码 插入 到 刚 定 义 的 块 里 。|IF 块 保护 了 运行 OS 低 于 ONEYCOMB 的 系统 不 
让 这 个 app 前 溃 。 


Listing 6-4. MultichoiceModeListener Example 


mListView.setChoijiceMode(ListView.CHOICE MODE MULTIPLE MODAL ) ; 
mListView.setMultiChoiceModeListener(new AbsListView.MultiChoiceModeListener() { 


QOverride 
public void onItemCheckedStateCchanged(ActionMode mode, int position, long id, bool 
ean 
checked) { } 
QOverride 
public boolean onCreateActionMode(ActionMode mode, Menu menu) { 
MenuInflater inflater = mode.getMenuInflater(); 
inflater.inflate(R.menu.cam menu, menu); 
return true,; 
QOverride 
public boolean onPrepareActionMode(ActionMode mode, Menu menu) { 
return false,; 
@Override 
public boolean onActionIitemClicked(ActionMode mode, MenuItem item) { 
switch en { 
case R.id.menuyu_item delete reminder: 
for (int nC = mCursorAdapter.getCount() - 1; nC >= 0; nC--) { 
If (mListView.isIitemChecked(nC)) { 
mDbAdapter.deleteReminderById(getIdFromPosition(nC)); 
ly 
mode .finish( ); 
mCursorAdapter .changeCursor(mDbAdapter.fetchAllReminders()); 
ete 
return false,; 
QOverride 
public void onDestroyActionMode(ActionMode mode) { } 
}); 


解决 所 有 导入 的 问题 。 你 将 注意 到 getIdFromPosition() 没有 定义 并 标 为 红色 (错误 ) 。 把 光 
标 放 在 这 文 个 方法 上 并 按 劳 取 醋 Alt_Enter 调用 IntelliSense 并 选 先 择 创 | 建 方法 。 选 

择 RemindersActivity 作为 目标 类 。 选 择 整 型 作为 返回 类 型 。 用 清单 6-5 的 代码 完成 这 个 方 

法 。 


Listing 6-5. getIdFromPosition() method 


private int getIdFromPosition(int nC) { 
return ts getItemId(nC); 


此 处 理 逻 辑 定 义 了 一 个 MultichoiceModeListener 并 把 它 附 到 |L istview 。 无 论 何 时 你 长 按 

ListView 的 一 个 条 目 时 ， 运 行 时 调用 oncreateActionMode() 方法 

在 MultichoiceModeListener 上 。 如 果 方 法 返回 上 真 值 ， 就 进入 多 选 动作 模式 。 这 里 重 写 方法 的 
逻辑 十 充 了 一 个 上 下 文 菜单 用 于 显示 动作 条 3 Co 黄 式 的 好 处 是 你 可 以 选择 多 行 。 

一 次 点 击 选 中 了 某 个 条 目 ， 接 下 来 再 点 击 则 会 去 选 这 个 条 目 。 当 你 点 击 上 下 文 菜单 里 的 每 个 

条 目 ， 运 行 时 将 带 着 被 点 的 条 目 调 用 onActionItemclicked() 方法 。 


在 这 个 方法 里 ， 通 过 比较 itemId 和 你 加 到 菜单 项 里 的 删除 元 素 的 id ， 检 查 下 删除 条 目 是 否 
被 点 击 了 。 (看 看 在 本 节 开 始 时 所 描述 有 关 删 除 条 目 ID 的 XML 清 sn 。 如果 这 个 条 目 被 选 ， 
轮 询 所 有 的 清单 条 目 并 要 求 mpbAdapter 来 删除 它们 。 在 删除 所 选 条 目 逻辑 调用 动作 模式 


对 象 finish() 方法 ， 这 将 禁止 多 选 动作 模式 并 返回 Listview 到 普通 模式 。 接 下 来 你 ? 

用 fetchAllReminders() 方法 众 数 据 库 重新 装载 所 有 的 提醒 条 并 传送 在 mcursorAdapter 机 

。 changecursor 方法 所 返回 的 游标 。 最 后 ， 方 法 返回 丨 值 来 表明 动作 被 正确 地 处 理 了 。 所 有 
它 的 没 被 正确 处 理 的 逻辑 ， 方 法 返回 假 ， 表 明 一 些 其 它 的 事件 监听 器 可 能 处 理 了 这 个 点 击 
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Android Studio 将 高 亮 一 堆 错误 语 撮 ， 因 为 你 正 使 用 的 API 无 效 或 低 于 Honeycomb。 这 外 错误 
生成 于 Lint， 一 个 状态 分 析 工 具 内 建 于 Android SDK 并 完全 整合 在 Android Studio 里 。 你 需要 
加 上 下 面 的 声明 在 RemindersActivity.oncreate() 方法 里 ， 在 6@override 声明 之 上 或 之 下 都 
行 ， 而 且 要 目标 API 解 决 导 入 问题 : 


@TargetApi(Build.VERSION_CODES .HONEYCOMB) 


这 个 特别 的 声明 告诉 Lint 坎 骗 方法 调用 是 提供 的 API 级 别 的 目标 ， 不 管 构 建 配 置 所 指定 的 。 提 
ee Adds Contextual Action Mode with context action menu 作 注释 。 图 6-7 描 写 了 
可 能 看 到 的 新 特性 。 


Buy Learn Androld Studio 


Send Dad birthday gift 

Dinner at the Gage on Friday 

String squash racket 

Shovel and salt walkways 

Prepare Advanced Android syllabus 
Buy new office chair 

Call Auto-body shop for quote 
Renew membership to club 


Rirnv new falavv Andrnid mhane 





图 6-7 允许 多 选 模式 


Implementing Add, Edit, and Delete 


迄今 为 止 ， 你 已 经 添加 了 从 清单 里 删除 提醒 的 逻辑 。 这 个 逻辑 在 上 下 文 动作 模式 里 也 可 以 有 
效 执 行 。 目 前 还 无 法 插入 新 提醒 或 编辑 现 有 的 提醒 。 无 论 如 何 ， 你 将 创建 一 个 用 户 自 定义 对 
话 框 或 添加 提醒 ， 另 一 个 用 来 编辑 现 有 的 提醒 。 最 终 ， 你 将 绑 定 这 些 对 话 框 


到 RemindersDbAdapter 。 


在 处 理 这 个 之 前 ， 先 添加 一 些 新 的 颜色 。 把 这 它们 加 到 colors.xml 文件 里 : 


<color name="1ight_grey">#bababa</color> 
<color name="black">#000000</color> 
<color name="blue">#ff1118ff</color> 


注意 : 通常 ， 你 的 app 可 能 有 一 个 全 面 的 颜色 风格 ， 这 将 保证 所 有 屏幕 和 对 话 框 的 一 臻 性。 无 
论 如 何 ， 颜 色 风格 超出 了 这 个 简单 例子 的 范围 了 。 


策划 一 个 用 户 对 话 框 


开发 的 一 个 好 习惯 是 : 以 简单 工具 优 于 执行 它 来 描绘 你 的 用 户 界 面 。 这 样 在 引入 任何 代码 之 
胶 ， 让 你 图 形 化 元 素 如 何 适 合 屏 幕 。 你 可 用 一 个 编辑 器 如 inkscape， 它 是 跨 平 台 的 ， 或 者 你 
可 以 用 笔记 本 的 纸张 和 铅笔 。 在 移动 商务 里 ， 这 些 描绘 称 作 线 框图 (wireframe)。 


图 6-8 是 我 们 的 用 户 对 话 框 的 插图 ， 完 成 于 inkscape。 这 个 线 框 图 有 意 不 正式 ， 来 强调 元 素 的 
摆 放 好 过 一 个 精准 的 外 观 和 感觉 。 


New Reminder 


lmportant 


图 6-8 线 框图 描绘 用 户 自 宋 义 对 话 框 





注意 : 这 本 书 里 的 一 些 用 户 自 定 义 的 绘图 和 线 框 图 正 是 用 Inkspace 创 建 的 ， 一 个 多 平台 向 量 
图 形 编辑 跨 。 在 www.inkscape.org Eb 它 是 免费 的 


把 线 框图 就 在 那 了 ， 你 可 以 开始 计划 如 何 排列 屏幕 的 元 素 。 因 为 大 多 数 元 素 从 上 排 到 下 ， 在 
最 外 层 用 一 个 坚 直线 性 布局 ， 这 是 最 显然 的 选择 。 不 管 怎样 ， 底 下 的 两 个 按钮 并 排 在 一 起 。 
这 样 你 可 以 用 一 个 水 平 线性 布局 放 在 前 面 的 坚 直线 性 布局 里 。 图 6-9 加 上 一 些 声明 来 描绘 和 高 
亮 这 些 内 贮 的 元 件 。 


BD 


Vertical TextView EditText 
Linear Layout | 


这 





New Reminder 


Check Box Lmportant 


Linear Layout 


图 6-9 线 框图 描绘 widget 标签 


从 策划 到 代码 


随 痢 线 框图 在 那 ， 尽 量 用 图 形 化 设计 器 来 开发 布局 。 开 始 在 res 目 录 上 右 击 并 选择 创建 一 个 新 
的 Android 资 源 文 件 然后 命名 为 dialog_custom ， 资 源 类 型 为 布局 资源 。 以 线性 布局 作为 根 元 
素 ， 完 成 对 话 框 。 接 着 我 们 的 线 框图 ， 从 调 色 板 拖 放 视图 控件 到 这 个 平台 上 。 清 单 6-6 包 含 了 
这 个 完成 的 XML 布局 文件 ， 并 带 有 将 在 代码 中 用 到 的 ID 值 。 


Listing 6-6. Completed dialog custom.xml 





<?xml] version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android 


android: 
android: 
android: 
android: 


id="@+id/custom root_ layout" 
layout_width="300dp" 
layout_height="fill parent" 
background="@color/green" 


android:orientation="vertical" 

> 
<TextView 
android:id="@+id/custom title" 


android 
android 
android 


:Jayout width="fill parent" 
:layout_ height="60dp" 

:gravity="center_vertical" 
android: 
android: 
android: 
android: 


padding="10dp" 

text="New Reminder:" 
textColor="Q@color/white" 
textSize="24sp" /> 


<EditText 


android 
android 
android 
android 


:1]d="@+1id/custom edit_ reminder" 
:lJayout width="fill parent" 
:layout_height="100dp" 

:layout_ margin="4dp" 

android: 


background="@color/l1ight_grey" 


android:gravity="start" 
android:textColor="@color/black"> 
<requestFocus /> 

</EditText> 

<CheckBox 
android:id="@+id/custom check_ box" 


android 
android 
android 


:Jayout_ width="fill parent" 
:layout_ height="30dp" 

:layout_ margin="4dp" 

android: 
android: 
android: 
android: 


background="@color/black" 
paddingLeft="32dp" 
text="Important" 
textColor="@color/white" /> 


<LinearLayout 


.Com/apk/res/android" 


android:layout width="fill parent" 
android:layout_ height="fill parent" 
android:orientation="horizontal"> 


<Button 
android:id="@+id/custom button cancel" 
android:layout width="Odp" 
android:layout_ height="60dp" 
android:layout _ weight="50" 
android:text="Cancel" 
android:textColor="@color/white" 
人 
<Button 
android:id="@+id/custom button_ commit" 
android:layout width="Odp" 
android:layout_ height="60dp" 
android:layout _ weight="50" 
android:text="Commit" 
android:textColor="@color/white" 
> 
</LinearLayout> 
</LinearLayout> 


生成 一 个 用 户 对 话 框 


现在 RemindersActivity 里 用 完成 的 对 话 框 布局 了 。 清 单 6-7 实 现 了 一 个 新 
的 fireccustomDialog() 方法 。 把 这 些 代 码 放 到 RemindersActivit 文件 里 去 ， 仅 
在 oncreateoptonsMenu() 方法 上 面 ， 并 解决 好 导入 的 问题 。 
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Listing 6-7. The firecustomDialog( ) Method 


private void fireCustomDialog(final Reminder reminder){ 


final Dialog dialog = new Dialog(this); 
dialog.requestwindowFeature(Window.FEATURE_ NO_TITLE); 
dialog.setContentView(R.1layout.dialog_custom); 
TextView titleView = (TextView) dialog.findViewById(R.id.custom title); 
final EditText editCustom = (EditText) dialog.findViewById(R.id.custom edit remind 
er ); 
Button commitButton = (Button) dialog.findViewById(R.id.custom button commit); 
final CheckBox checkBox = (CheckBox) dialog.findViewById(R.id.custom check_box ) ; 
LinearLayout rootLayout = (LinearLayout) dialog.findViewById(R.id.custom root_ layo 
ut ); 
final boolean isEditOperation = (reminder != null); 
if (isEditOperation)t 
titleView.setText("Edit Reminder"); 
checkBox.setChecked(reminder .getImportant() == 1); 
editCustom.setText(reminder.getContent( )); 
rootLayout.setBackgroundColor(getResources().getColor(R.color.blue)); 


commitButton.setOonClickListener(new View.OnClickListener() { 
@Override 
public void or ck(View v) { 
String reminderText = editCustom.getText().toString(); 
if (isEditOperation) { 
Reminder reminderEdited = new Reminder(reminder .getId()， 
reminderText, checkBox.isChecked() ? 1 :; 0); 
mDbAdapter .updateReminder (reminderEdited),; 
} else i 
mDbAdapter .createReminder(reminderText, checkBox.isChecked( )); 
mCursorAdapter .changeCursor(mDbAdapter.fetchAllReminders( )); 
dialog.dismiss(); 
} 


}); 
Button buttonCancel = (Button) dialog.findViewById(R.id.custom button_ cancel); 


buttonCancel.setOonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
dialog.dismiss(); 


}); 
dialog.show( ) ; 


firecustomDialog( ) 方法 将 用 于 插入 和 编辑 ， 就 算 它 们 间 有 少许 不 同 。 方 法 的 开始 三 行 创建 
了 一 个 Android 对 话 框 ， 没 有 标题 并 填充 清单 6-6 的 布局 。 firecustomDialog( ) 方法 接着 从 这 
个 布局 里 查找 所 有 重要 的 元 素 并 储存 到 本 地 变量 里 。 然 后 方法 查看 reminder 参 数 是 否 为 空 ， 
设置 一 个 isEditoperation 布尔 变量 。 如 果 说 有 一 个 提醒 被 传 入 (或 者 值 为 不 空 ) ， 方 法 会 假 
设 这 不 是 一 个 编辑 操作 并 把 这 个 变量 设 为 假 ; 否则 ， 设 为 夏 。 如 果 调 

用 firecustomDialog( ) 方法 的 是 一 个 编辑 操作 ， 标 题 设 为 Edit Reminder 而 

且 checkBox 和 EditText 用 提醒 参数 的 值 来 设 定 。 这 个 方法 也 设置 了 最 外 层 容器 布局 的 背景 
色 为 蓝 色 ， 为 了 从 视觉 上 区 别 插入 对 话 框 和 编辑 对 话 框 。 


接 下 来 的 几 行 由 一 个 代码 块 组 成 . 为 提交 按钮 设置 及 定义 一 个 OnClickListener 0° 这 个 监听 装 
响应 点 击 事件 ， 更 新 数据 库 。 再 次 ， isEditoperation() 被 检查 了 ， 如 果 编 辑 操作 进行 中 ， 那 
么 一 个 新 提醒 创建 了 ， 用 来 自 提 醒 参 数 的 ID 以 及 EditTex 的 值 还 有 在 屏 的 复 选 框 值 。 这 个 提 


醒 传 送 给 mDbAdapter ， 通 过 updateReminder() 方法 。 


如 果 编 辑 没 有 进行 ， 这 个 逻辑 查询 mpbaAdapter 来 创建 一 个 新 的 提醒 到 数据 库 ， 用 EditText 的 
还 有 在 屏 的 复 选 框 值 。 在 无 论 是 更 新 或 创 ee 所 有 提醒 通 

过 mcursorAdapter ,changecursor() 方法 会 重新 装载 .这 个 逻辑 有 点 象 之 前 添加 的 清单 6-5 代 码 。 

点 击 监 听 器 在 提醒 重新 装载 后 解散 对 话 框 。 


在 配置 提交 按钮 的 点 击 行为 后 ， 这 个 例子 设置 CE 。 这 个 监听 器 只 下 
简单 地 解散 对 话 框 。 所 有 按钮 的 行为 定义 后 ， 这 个 例子 结束 于 显示 用 户 对 话 框 。 


现在 你 可 以 为 在 oncreate() 方法 里 的 modeListView 用 这 个 新 方法 
在 onItemCclickListener 中 。 为 这 个 监听 器 找到 onItemclick() 方法 用 下 面 的 代码 替换 原来 所 


有 代码 。 


人 OT LOM SS A oe parent, View view, int position, long 1d) 1 
if (position == 0) { 
Int nId = getIdFromPosition(masterListPosition); 
Reminder reminder = mDbAdapter.fetchReminderById(nId); 
BE 





i 
mDbAdapter.deleteReminderById(getIdFromPosition(masterListPosition)); 
mCursorAdapter .changeCursor(mDbAdapter.fetchAllReminders()); 


dialog.dismiss( ) ; 


为 了 编辑 提醒 去 掉 Toast.makeText() 调用 ， 替换 为 用 ListView 位 置 来 找到 提醒 的 调用 ?这 
价目 提醒 然后 被 传送 到 firecustomDialog() 方法 来 触发 编辑 行为 。 为 删除 提醒 ， 用 和 清单 6-5 
一 样 的 代码 逻辑 。 再 次 ， mpDbaAdapter ,deleteReminderById() 用 于 删除 提醒 ， 并 

且 changecursor() 用 于 从 mDbAdapter.fetchAllReminders() 调用 中 返回 游标 。 


找到 onoptionsItemSelected() 方法 ， 在 RemindersActivity.java 文件 很 底部 的 地 方 ， 编 辑 它 
如 清单 6-8。 


Listing 6-8. onoptionsItemSelected Definition 


public boolean onOptionsItemSelected(MenuItem item) { 
switch (item. er { 

case R， 1d. On New: 
et a 
return true; 

Case Ro ee on 
finish( ); 
Petwun Crue.: 

default: 
return false; 


这 里 ， 当 你 选择 了 菜单 项 是 action_new ， 简 单 地 调用 了 firecustompialog() 。 传 送 一 个 空 值 
给 它 ， 象 之 前 提 及 的 空 值 检 查 并 设置 isEditoperation 为 假 ， 然 后 征用 一 个 新 提醒 对 话 框 。 运 
行 app 检 查 下 新 特性 。 你 会 看 到 新 的 用 户 对 话 框 。 当 创建 新 提醒 时 ， 你 将 看 到 一 个 绿色 对 话 
人 测试 菜单 项 确保 创建 
和 删除 操作 功能 象 它们 应 该 的 那样 。 提 交 更 改 到 Git， 附 上 提交 信息 : Adds database Create， 
Read, Update, and Delete support with custom dialogs ° 


New Reminder: 








Important 


Cancel 





图 6-10 新 提醒 对 话 框 


Edit Reminder 


Buy Learn Android Studio 


Important 


Cancel Commit 





图 6-11 编辑 提醒 对 话 框 


加 上 用 户 图 标 


所 有 的 特性 都 放置 好 了 ， 你 可 以 加 上 一 个 用 户 图 标 作为 完成 点 级 。 可 以 用 任何 图 形 编辑 器 来 
创建 它 ， 或 者 如 果 你 不 喜欢 图 形 编 辑 ， 从 网 上 下 点 免费 的 。 我 们 的 例子 放置 ic_ launcher 图 

标 ， 它 创建 于 Inkscape。 找 开 项 目 工具 窗 并 右 击 res/mipmap 目录 。 选 New > Image Asset 。 将 
看 到 图 6-12 那 样 的 对 话 框 。 点 击 Image File: 选择 框 最 右边 的 省 略 号 图 标 ， 导 航 到 你 要 的 图 上 
位 置 并 插入 进来 。 让 其 他 的 设置 如 图 6-13 所 示 。 点 下 一 步 ， 接 着 点 完成 。 


Asset Type: LauncherIcons 
Foregroun 中 (®) Image (Clipart 


lImage file: CN\androidBoolMic launcher.png 


L_| Trim surrounding blank space 
Additional padding: 已; 
Foreground scaling: (%) Crop ©) Center 


Shape: (®) None (0 Square OO Circle 
Background color: | | 
esource rame 


Description 
Adrawable resource narmed ic_launcher already exists and will be overwritten. 





图 6-12 新 图 片 资 源 对 话 框 


有 不 少 目录 使 用 了 mipmap 这 个 名 字 。 这 些 目录 每 个 都 有 着 后 级 ， 那 个 指派 屏幕 尺寸 限定 。 
Android 运 行 时 将 从 特别 的 目录 里 拉 出 资源 ， 依 照 app 所 运行 设备 屏幕 的 解析 度 。 资 源 夹 和 它 
们 的 后 组 在 第 8 章 将 有 祥 解 。 


插入 下 面 的 几 行 代码 到 oncreate() 方法 里 ， 在 填充 布 局 之 后 ， 
即 setcontentView(R.layout.activity_reminders); 。 这 些 代 码 将 显示 用 户 图 标 在 你 的 动作 条 
全。 


ActionBar actionBar = getSupportActionBar(); 
actionBar.setHomeButtonEnabled(true); 
actionBar.setDisplayShowHomeEnabled(true); 
actionBar.setIcon(R.mipmap.ic_launcher ); 


运行 代码 ， 将 看 到 用 户 图 标 在 动作 条 里 。 图 6-13 展 示 了 以 用 户 图 标 运行 的 app。 





画 5554INeaus 5 lessvlass 





RernmlInmders 


Buy Learn Androld Studio 
Send Dad birthday gift 
Dinner at the Gage on Friday 
String squash racket 


Sshovel and salt walkways 


Prepare Advanced Android syllabus 





Buy new office chair 
Call Auto-body shop for quote 
Renew membership to club 
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图 6-13 动作 条 的 用 户 图 标 


按 ctrl+K | cmd+K 提交 更 改 到 Git， 以 Adds a custom icon 作 为 提交 信息 。 


茶 音 ! 你 已 实现 了 使 用 Android Studio 完 成 的 第 一 个 Android app。 在 这 个 过 程 里 ， 你 学 会 了 
用 图 形 化 设计 器 编辑 XML 布 局 文件 。 你 也 学 会 了 如 何 用 文本 模式 编辑 一 个 行 XML 布 局 。 这 章 
展示 了 在 支持 的 平台 上 如 何 有 条 件 地 实现 上 下 文 动作 模式 。 最 后 ， 你 看 到 了 如 何 加 载 一 个 用 
户 图 标 到 不 同 的 分 辩 率 的 屏幕 上 。 


